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Preface 


This book is your introduction to the Timex Sinclair 1000 and Sinclair 
ZX81 personal computers. It describes the computers themselves and covers 
the common external devices and accessories, including the television dis- 
play, eassette program storage, memory expansion, and printers. 

The book has three main parts. Each part focuses on one kind of Timex 
Sinclair computer user. The first part addresses the person who plans to use 
commercially prepared programs but has little or no desire to program the 
computer. The second part teaches the programmer or prospective pro- 
grammer how to use BASIC on these computers. The third part presents 
more advanced information about Sinclair BASIC and the Z80 micro- 
processor and explains how to take advantage of some of their special charac- 
teristics. These three parts are not mutually exclusive. Users of the first part 
may venture into the second part just to see what BASIC programming is all 
about. Users of the second and third parts are likely to find themselves 
referring to the first part from time to time. 

The first two chapters answer two questions: “What is the TS1000 (or 
ZX81) computer?" and “How do you make it work?" The first chapter tells you 
what all the pieces of the computer system are and what they do. The second 
chapter describes the system in greater detail and tells you how to operate 
each component part. With this knowledge you are ready to use any of the 
ready-to-run programs that are available for text processing, financial anal- 
ysis, bookkeeping, computer-aided instruction, and entertainment. 

Chapters 3 through 6 teach you how to write your own BASIC programs. 
Chapter 3 begins with the fundamentals of Sinclair BASIC. Chapters 4, 5, 
and 6 describe the features of BASIC in greater detail, explaining what 
computer programming is all about and describing some of the things you 
can do with this knowledge. 

Chapters 7 and 8 present more advanced aspects of the Timex Sinclair 
computers that will interest more experienced programmers and new users 
who have mastered the fundamentals. 

The appendixes provides valuable reference information for each kind of 
user. Appendix Á is a summary of Sinclair BASIC for readers who already 
understand BASIC and want to look up the details of particular commands 
or functions. Appendixes B through D contain general reference material 
for programmers, and Appendixes E through M describe more advanced 
aspects of these computers. Appendix N is a bibliography of other related 
books and magazines. 
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his chapter introduces you to the TS1000 and ZX81 computers. In it 

you will learn about the basic functions of these computers' parts, 

from the microprocessor (the *brain" of the system) to the keyboard. 
The chapter also introduces you to the basic equipment that can be attached 
to your computer to make it more useful, for example, a cassette recorder (to 
save your programs) or more memory (to enable you to run longer and more 
complex programs). 


THE COMPUTER 


Figure 1-1 is a picture of the Timex-Sinclair 1000 computer (hereafter 
called the TS1000). Figure 1-2 shows the Sinclair ZX81. These two comput- 
ers are essentially identical, except that the TS1000 has more memory. This 
book applies equally to both computers. Where it describes one, you can 
assume the other works exactly the same way. 

The computer contains a Z80 microprocessor chip, two kinds of memory, a 
built-in keyboard, and circuitry that can control a television, cassette record- 
er, printer, and memory expansion pack. Figure 1-3 shows the inside of the 
computer. You don't have to understand how the electronic components work 
in order to be able to use the computer, but the sections that follow discuss 
each of the major components briefly so that you will know their names and 
functions. 

You may be surprised to learn that your computer has so few internal 
components. Ás you can see from Figure 1-3, the computer's circuitry con- 
sists of only four integrated circuits: the microprocessor; & custom logic 
circuit (called a ULA); two memory chips; and a few small components. Each 
chip contains a large amount of internal circuitry, most of it so small that you 
could not see it without the aid of a microscope. 
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Figure 1-1. TS1000 


Figure 1-2. ZX81 
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Timex Corporation 


Figure 1-3. Inside the computer 


The Microprocessor 


Memory 


The SCL 


The microprocessor or CPU (Figure 1-3) is the “brain” of the computer. It 
executes the instructions of your program one at a time by performing 
arithmetic functions, comparing and manipulating numbers, and transfer- 
ring data from one location to another in memory. It also creates the televi- 
sion display and communicates with the cassette unit. 


The memory chips are used for storing information. Your computer has two 
different kinds of memory, called read-only memory (ROM) and read/write 
memory (RAM, which means random-access memory). These chips contain 
thousands of storage units called bytes where programs, data, text, and other 
kinds of information are stored. 


Besides the microprocessor and memory chips, your computer contains a 
eustom-made chip called the SCL, which provides special circuitry for con- 
necting other chips and generating the cassette, video, and keyboard signals. 
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The letters SCL stand for “Sinclair Computer Logic.” The chip used is called 
a ULA (Universal Logic Array). It is programmed at the factory to perform 
the SCL functions. 

The computer also contains a voltage regulator and a video modulator. The 
voltage regulator controls the power to the computer and the video modulator 
converts the computer display data into a standard broadcast signal so you 
can use your television set for the video display. 


PUTTING THE SYSTEM TOGETHER 


Figure 1-4 is a picture of a typical TS1000 computer system. The system 
configuration of a ZX81 is identical. Your system may differ from the one 
pictured because some of the components shown are optional. Your television 
set and cassette recorder/player may also be different from the ones shown 
since neither Sinclair nor Timex markets their own televisions or recorders. 

Only two of the components shown in Figure 1-4 are necessary for a 


Figure 1-4. The TS1000 computer, memory expansion pack, cassette 
recorder/player, printer, and television screen 
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working computer system: the computer itself (including the built-in key- 
board) and the television set. The cassette unit is used to save programs and 
load them into the computer from tape. The Timex 2040 printer shown prints 
both programs and the results of calculations onto paper. 

The memory expansion pack increases the memory to 16,384 bytes (called 
16K bytes in the number system used in computers). With this added memory, 
the computer can handle longer programs and more data. 


The Keyboard 


The built-in keyboard is your main way of giving instructions to the 
computer. The TS1000 and ZX81 accept commands in a language called 
BASIC, which uses a small number of English words, along with numbers 
and a few other symbols, in a fairly simple and systematic way. Much of this 
book will explain how to use the language BASIC. For now, notice that the 
keyboard has all of the special words and other symbols of BASIC printed on 
the keys. This can make the TS1000 and ZX81 much easier to use than many 
other personal computers that require you to remember all the special words 
and type them in yourself, letter by letter. 


The Video Display 


Thetelevision screen displays the interaction between you and the comput- 
er. It displays each command or keyboard character as you type it in. It also 
displays a special symbol called a cursor, which tells you what kind of 
information the computer expects you to enter next and where it will appear. 

The screen is divided into 24 lines of 32 characters each. Although you can 
use just about any kind of television, a small black and white set will probably 
give the best picture. 


Expansion Interface 


Atthe rear of the computer is a long, flat connector. This connector is the 
expansion interface. It is used to connect various devices to the TS1000 and 
ZX81 computers. 

Two of the devices that connect to this interface are the 16K memory pack 
and the Timex 2040 or Sinclair ZX printer. 


Memory and Memory Expansion 


In any computer system, the mieroprocessor (also called the Central Pro- 
cessing Unit, or CPU) performs all of the logical functions of the computer. 
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But in order for it to perform these functions, it is necessary to have a 
controlling program. This program can be stored in memory as either a 
permanent (or nonvolatile) program, such as the BASIC programming lan- 
guage, or in temporary memory, such as programs you enter. 


THE MASTER PROGRAM 


The TS1000 and ZX81 computers have two different kinds of memory. 
Read-only memory (ROM) contains the master program that controls every 
aspect of the computer's operation. When you plug in the computer, this 
master program automatically takes over. When you enter commands or 
programs for the computer to execute (in BASIC), it is this master program 
in ROM that instructs the microprocessor to interpret your commands and 
carry them out. The ROM contains permanently stored information that was 
placed there at the factory, and you cannot change it. 


DAIA AND PROGRAM STORAGE 


The other kind of memory in your computer is called read/write memory 
(RAM), because you can change (write) its contents as well as read what was 
previously written into it. The letters R. A.M. are an acronym for random- 
access memory. Although both ROM and RAM can be accessed randomly, 
only read/write memory is called RAM. When you enter and run a program 
of your own, the microprocessor stores your program and the data it needs in 
RAM. It also keeps track of where these things are stored, so that you can find 
them easily when you need them. 

When you turn off the power, everything stored in RAM disappears. If you 
saved the program on cassette before turning off the power, you can recall it 
by loading it into RAM; otherwise you will have to retype it. 

Both ROM and RAM are made up of individual storage units called bytes. 
Each byte can contain one character, such as a letter, a punctuation mark, or 
a graphic symbol. The more bytes you have, the more information (programs, 
numbers, or text) you can store in your computer. 

Memory capacity is usually described in units of Kbytes (sometimes simply 
called K). One Kbyte means 1024 bytes. The TS1000 and ZX81 have 8K bytes 
(that's 8192 bytes) of ROM. Additionally, the TS1000 has 2K bytes (2048 
bytes) of RAM, while the ZX81 has 1K byte (1024 bytes) of RAM. With the 
optional memory expansion pack, each computer has a total of 16K, or 16,384 
bytes of RAM. 
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his chapter begins by telling you how to hook up your computer and 

make sure it is working correctly. It also describes different parts of 

the computer system and how to use them. These are the television 
display, the key board, the cassette recorder, the printer, and the 16K memory 
pack. 


SETTING UP THE SYSTEM 


Find the video cable that came with the computer and plug it into the 
socket marked “rv” on the left side of the computer (Figure 2-1). Make sure 
the plug goes all the way in, sothat the metal flangeon theoutsideof the plug 
makes good contact with the outer surface of the socket. 

Connect the television switch box terminals (marked “rv”) to the VHF 
antenna terminals on the back of your television set (Figure 2-2). Connect the 
switch terminals marked “ANTENNA” to the antenna, and plug the free end of 
the video cable into the connector marked “COMPUTER.” Set the switch to the 
“COMPUTER” position. 
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Figure 2-2. The television switch box connects to VHF antenna terminals 
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Theoptional 16K memory pack plugs into the edge connector on the back of 
the computer (shown in Figure 2-3). If your system has a Timex 2040 printer, 
plug it into the connector first and plug the 16K memory pack into the other 
side of the printer connector. 


When You Plug In Power 


Plugthe power supply into an ordinary 110 volt outlet. Plug thesmall jack 
from the power supply into the socket marked “ӘУ DC” on the left side of the 
computer (Figure 2-4). 

Use the switch on the bottom of the computer to select either channel 2 or 
channel 3, and tune the television set to the same channel. Use the channel 
that gives you the better picture. 

Shortly after the power is connected, a white Ш on a black background will 
appear at the lower left-hand corner of the screen. This is the cursor. Figure 
2-5 shows the display right after power-up. The Й cursor is one of several 
cursors that the ZX81 and TS1000 computers use. All of them are displayed, 
like the $ cursor, in reversed video — white on a dark background. 


Adapted from Timer User Manual by Steven Vickers, 9 1982 Timex Corporation 


Figure 2-3. The 16K memory pack plugs into the edge connector 


42 The ZX81/TS1000 Home Computer Book 


Figure 2-4. The power supply's jack plugs into the socket 9V DC 


Figure 2-5. Television display when computer is turned on 
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Table 2-1 describes all of the possible cursor characters that you will 
encounter with the TS1000 or ZX81 computers. 

Adjust the fine-tuning, horizontal, and vertical controls on the television 
set until you get a display similar to the one in Figure 2-5. Adjust the 
brightness and contrast for the clearest, most comfortable view. 

If you run into any problems getting this display, refer to the troubleshoot- 
ing guide at the back of the book. 


THE KEYBOARD 


The keyboards of the T81000 and ZX81 (Figure 2-6) have all the letters and 
numbers of an ordinary typewriter keyboard. Most of them are arranged in 
thesame pattern as on atypewriter. The comma and sPACE keys, however, are 
at unfamiliar locations, and there is only one SHIFT key. Also, there is a key 
marked ENTER, which you must press at the end of each line to tell the 
computer that the line is complete and ready to be processed. 


Table 2-1. Cursors 


я Keyword 

Ш Letter or Number 

Gi Function 

E Graphics Symbols or Reversed Video 
КУ Syntax Error 


EDIT AND THEN TO GRAPHICS DELETE 
ПЕ y En nt i) ЕШ СІ 
STEP 
FB ГЕ Ê B UH ng Јо ГВ 


STOP LPRINT SLOW FAST LLIST FUNCTION 
al. C d. 
7 EB FE ao 8” МІ. 


Figure 2-6. Т 510090 or ZX81 keyboard 
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Many of the keys contain three or four other symbols or functions in 
addition to the standard letter or number. Some of these are mathematical 
symbols like +,-, and =, or punctuation marks such as “or ;. Other keys have 
special graphics symbols for drawing pictures or graphs on the screen. Other 
keys contain words, such as INPUT, STOP, and PEEK, which are keywords, or 
commands, in the BASIC programming language. 

In this chapter you will learn how to select any one of the symbols on the 
keys, and you will seesome examples of how to usethem to give commands to 
the computer. Don't worry if you don't understand these commands. They 
will become clear as you follow the examples in this book. 


Letters and Keywords 


BASIC Look at the key marked with a large capital E. It is located on the second 
Keyword row of keys from the top, three keys in from the left end of the row. 

The word REM is a BASIC keyword. Keywords on the T81000 and 2Х 81 are 
BASIC commands. The keywords, letters, and numbers arethe symbols that 
you will use most often. The & cursor that you see on the screen (Figure 2-5) 
indicates that the computer expects a keyword at this point. If you press the 
REM key now, the word REM will appear on the screen. Do it and observe the 
display. The 18 cursor has disappeared, and in its place is the line: 


REM № 


The Y cursor means that the computer is now expecting a letter or a number 
instead of a keyword. If you press the E key again, it will producetheletter E 
instead of REM. 

Allofthe words written above the white letter keys are BASIC keywords. 
If you press any letter key while the # cursor is visible, the screen will 
display the word that is written above the letter. When the № cursor is visible, 
thescreen will display the letters themselves. The letters are printed in solid 
black on the white keys. All of the numbers, together with the period, ENTER, 
and sPACE symbols, are also printed in black. However, they do not have 
keywords above them, and they give the same result on the screen regardless 
of whether the 3 or Y cursor is showing. (The BREAK written above the SPACE 
key is not a keyword, although it looks like one. It doesn’t get printed.) 


The SHIFT Key 


The ѕніғт key, like the shift key of an ordinary typewriter, does not do 
anything by itself; it only changes the effect of pressing the other keys. Since 
the only letters on the TS1000 keyboard are capital letters, the знтет key does 
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not distinguish capital letters from lowercase ones. Instead, it selects the 
symbol that is printed in red on any other key that you press while sHIFT is 
held down. This book uses SHIFT- to denote a shifted key. For example, SHIFT-E 
will display the word STEP that is printed in red on the E key. 

Each of the shifted keys does exactly the same thing regardless of whether 
the М or the ТЕ cursor is showing. 

Some keys on the top row do not print anything on the screen when you 
SHIFT them. Instead, they perform special editing operations for entering 
and correcting programs. For example, the DELETE key (SHIFT-0) erases the 
last symbol you typed. Type a few symbols and then type DELETE several 
times. Thecursor will back up and erasethe symbols from the display. If you 
have typed more than enough symbols to fill one line, the display continues on 
thenext line. DELETE will erasethe symbols on both lines, one at a time, in the 
reverse of the order they were entered. DELETE will not, however, move the 
cursor back past the spot where it originally appeared when you connected 
the power. 

The CURSOR-LEFT key (shown as a horizontal left arrow, —) is similar to 
DELETE, but it moves the cursor backward without deleting the symbols it 
passes over. The CURSOR-LEFT key is obtained by pressing sHIFT-5. Type some 
more symbols, and then use CURSOR-LEFT to move the cursor back. SHIFT-8 
(the CURSOR-RIGHT key, —) moves the cursor to the right, again leaving intact 
any symbols that it passes over. 

The computer has an automatic insert function. When the cursor is between 
two symbols, any new symbol that you type will appear just to the left of the 
cursor, and the rest of the line will move to the right to make room for it. 

The CURSOR UP and DOWN keys (SHIFT-7, t, and SHIFT-6, |) are for moving the 
cursor from one line to the next when you have several program lines on the 
screen. Chapter 3 will eover these in more detail. 


The FUNCTION Key 


Function 


The symbols below the white key squares are called functions, although 
some of them, such as TAB and AT, are not functions in the mathematical 
sense. To use the function symbols, first press the FUNCTION key (SHIFT- 
ENTER). Notice that a new cursor, with the symbol iz for FUNCTION, has 
appeared. Now press the TAN key. It is the same one that has REM, the letter E, 
and STEP on it. 

You can produce any of the symbols that are written below the key squares 
by using the FUNCTION key, and it doesn't matter whether the Hor Y cursor 
was showing at the time. Remember that the FUNCTION key is a prefix key; you 
use it before pressing the key that has the symbol you want to display. This is 
different from the знтет key, which you hold down while you press the other 
key. 
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The GRAPHICS Key 


Graphics 


Symbol | 


There is one more set of symbols on the computer keyboard. These are the 
special graphics symbols that are used to draw pictures and graphs. This set 
also includes the reverse-video versions (white characters on a black back- 
ground) of the other characters. 

To produce these symbols, first press the GRAPHICS key (SHIFT-9). The cursor 
will change to the ® symbol. Press the E key and the 3 prints in reverse 
video. The {8 cursor will not be reset to the № cursor automatically after 
another key is pressed, the way the lal cursor was. To get the ог № cursor 
back, press GRAPHICS again. 

With the E cursor showing, press SHIFT-E. The character that appears on 
the screen is a dark square with its lower right quarter missing. It looks just 
like the symbol that is printed on the same keyboard key with the E. This 
symbol, and the others like it, are used for drawing pictures or graphs on the 
screen. 

Some of the keys on the keyboard do not have a graphics symbol on them, 
and they behave differently from the others when you shift them in graphics 
mode. The u key is an example. 

Put ће computer into graphics mode. Then enter SHIFT-U. You will see that 
the dollar sign В appears in reverse video. The keys with no graphics sym- 
bols will all produce red characters in reverse video when you shift them 
while in graphics mode. 

You have now tried all the different kinds of symbols that a key on your 
ZX81 or TS1000 can produce. For practice, you may want to choose a key that 
has all of them, such as w, and try to display each symbol that it contains. 


The ENTER Key 


While you were trying out the different key combinations described above, 
the computer did not interpret any of your entries as commands. This is 
because it was waiting for you to press ENTER before executing any command. 

To see how ENTER works, press the PRINT key, followed by the number в. The 
screen now reads 


PRINT 3F 


Now press ENTER. The computer does exactly what the command said to do: it 
prints the number 8 at the top of the screen. 
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The numbers 0/0 at the bottom of the screen are a code to tell you whether any 
errors occurred whilethe command was being executed. You will learn more 
about them later. 

There is no longer a cursor on the screen, but the computer will behave 
exactly as if it had the E cursor. Аз soon as you type something else, the 
correct cursor will appear. 


ERRORS AND THE E CURSOR 


The computer can display one more cursor, and it is probably the most 
useful one of all. It tells you when you have made a mistake in typing a line. 
Most computers will let you type almost anything you want into a program, 
even if it violates the rules of the BASIC programming language and will 
cause an error later when you try to run the program. The TS1000 or 2Х81, 
however, finds as many errors for you as it can and marks them with the 
cursor. 

To demonstrate how this works, first DELETE anything you may have typed 
in on the bottom line. Make sure the (B cursor is showing, and then type 


PRINT 4" 


Remember to usethe key with the PRINT symbol on it instead of trying to type 
the individual letters of the word. SHIFT the same key to produce the quota- 
tion symbol after the 4. 
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Now press ENTER. The computer refuses to accept the line —the line does 
not appear at the top of the screen. The E cursor appears to the left of the 
quotation symbol because the symbol is not "legal" in this context: 


PRINT4 B" 


The computer will put the & cursor to the left of the first item that it 
detects is in error. Since it can't know exactly what you meant to enter, 
however, the & may appear farther to the left or right than the actual 
beginning of your error. 

Delete the quotation symbol and watch the E cursor disappear. Now type a 
comma and a 5. The line should look like this: 


PRINT 4,58 


Press ENTER and the computer will print the numbers 4 and 5 at the top of the 
screen. 

Remember, though, that no computer can catch every programming mis- 
take that anyone could possibly make. The computer will mark with the & 
cursor any syntax errors —things that violate the rules of BASIC —that it 
detects within a single line. It will make sure that you do not enter numbers or 
single letters where a keyword is expected (remember the Й and № cursors). 
But the computer cannot find errors that involve the relationships between 
different lines of your program until the program actually runs. In addition, 
since the computer has no way of knowing what you intended, it may oeca- 
sionally execute valid programs that do something you didn't want. 

Table 2-2 summarizes the functions of the various symbols on the key- 
board. Use this table as a guide to the multiple functions on the keys. 
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Table 2-2. Keyboard Symbols 


Symbol Keyboard Location How to Display It Example 
Keyword Above key square Press with & showing REM 
Letter or number On key square Press with № showing E 
Red symbol On key square Press with SHIFT STEP 
Function Below key square Prefix with TAN 

FUNCTION key 

Reversed video For letter or Turn E on with a 
number GRAPHICS key, 

then press selected key P 
Graphics symbol Ор some key Turn E on with 
squares GRAPHICS key, 


then press selected 
key with SHIFT 


Reversed video For shifted symbol Turn E on with B 
on keys without GRAPHICS key, 
graphics symbol then press selected 


key with SHIFT 


YOUR FIRST PROGRAM 


Now that you know how to use all the features of the keyboard, you are 
ready to write your first program. First delete any symbols left on the screen. 
Then type NEW (on the A key) and press the ENTER key to make sure the 
computer is clear and ready for a program. To enter the program, type in the 
lines at the end of the next paragraph, exactly as they appear on the page. 
Type only the words between quotation marks. All of the others are on the 
keyboard as keywords, like NEW, or as functions, like AT. Don't type any 
spaces between words or symbols (except between quotation marks). The 
computer will provide all the spaces that you need automatically. 

Some of the program lines are too long to fit on a single line of the screen. 
Don't worry about that; the computer will automatically go to the next line 
when you get to the end of a line. Just remember to press ENTER whenever you 
get to the end of one of the lines as they are shown. If you make a mistake, 
simply re-enter the line correctly and it will replace the incorrect one.’ 


= зои 
‚20 PRINT "I NEVER MAKE MRSTARE 


га PAUSE эра 
за PRINT AT 2,71 “HWHODFS" 
аа PAUSE le 


En 


1 Adapted from a program by A. Kohlenberg, Syntax ZX80 (The Harvard Group, Bolton Road, Harvard, 
Mass., 01451, May 1982), p. 17. 
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за FOR Y-25 TO 14 STEP -i 
Ев PRINT AT 2,Yv; "M" 
үрө ө 


"ET 


"HELL, HARDLY 
Now press RUN, then press ENTER, and watch the program run. 


USING A CASSETTE PLAYER 


Your TS1000 or ZX81 comes equipped with jacks for connecting a cassette 
recorder/player. These jacks are on the left side of the computer and are 
clearly marked MIC and EAR (Figure 2-7). You can save and load programs 
that you write with the ZX81 or the TS1000, or you can buy and load 
prerecorded tapes with many kinds of programs on them. 


Figure 2-7. A cassette recorder plugged into the TS1000 
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Choosing a Recorder and Tapes 


Almost any cassette unit that is used for recording and playing music and 
speech will work just fine with the ZX81 or TS1000, as long as it has 
microphone and earphone jacks that match the cables supplied with the 
computer. It's convenient if your player has a tape counter that keeps track of 
where you are on the tape. This makes it easier to go directly to the program 
you want. 

Be sure to use short (30 minutes or less), high-quality audio cassettes. In 
fact, cassettes with only five or ten minutes of playing time are actually 
better than longer ones, since you can rewind them quickly. They make it 
easier to go from onetaped program to another and to use both sides without 
having to wait for the computer to read through many programs to get to the 
right one. 


Using Prerecorded Programs 


If you have program tapes for your TS1000, you can begin using the 
programs on the tapes now, even before you read about how to program the 
computer. 

Before attempting to load a program from tape, try listening to one of the 
tapes to see what it sounds like. You will not be able to recognize the individ- 
ual commands of the program by the way they sound, but what you hear will 
help you to find the best adjustment of the cassette player's tone and volume 
controls. 

Begin with the tone control set all the way toward treble and the volume 
control fairly low. Place the cassette in the cassette player and rewind the 
cassette to the beginning. Depress the PLAY button on the cassette player and 
listen. There may be a brief period of silence at the beginning while the tape 
leader passes through. Then you should hear a low-pitched humming sound. 
This sound was made by the computer that recorded the tape while it was 
waiting for the command to record. 

Before long the hum will stop and there will be a 5-second period of silence, 
followed by an unpleasant screeching noise. The silent period marks the 
beginning of the program. If the player is not completely silent during this 
period, there is either a bad connection between the player and the computer 
or you have a source of interference, such as electrical machinery, nearby. In 
some cases you can read tapes successfully despite interference by adjusting 
the tone control to make this silent period as quiet as possible. The best thing 
to do, though, is to eliminate the source of the interference. 

The screeching noise after the silent period is the recorded program itself. 
Adjust the volume so that the noise is unpleasantly loud, but not quite 
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deafening, and stop the cassette player. Now you are ready to load a taped 
program into the computer. Rewind the cassette and connect one of the cables 
supplied with the computer to the jack on the computer marked "EAR" 
(Figure 2-7). Connect the other end of the cable to the EAR or EARPHONE 
jack of your cassette player. It's best not to connect a cable to the mic jacks 
while you are loading a tape, since some cassette players will not work 
properly with both cables connected. 

If the television screen has anything but the ІР cursor on it, use DELETE to 
erase the symbols on the screen, type NEW (using the NEW key), and press 
ENTER. Now press the LoAD key (the same key as the letter J), followed twice 
by sHIFT-P. The screen should look like this: 


LOAD "om 


The two quote symbols tell the computer to load the first program that it 
findson thetape. If you know the namethat was given to the program when it 
was recorded, you can typethat name between the quotes. The computer then 
will search through the tape until it finds a program by that name, even if it is 
not the first one. Now press ENTER and you will see a pattern of lines on the 
screen, like the one in Figure 2-8. This video pattern occurs because the 
computer uses some of the same circuits for the cassette signals that it uses 
for the video. You can use this pattern to monitor the computer's progress in 
loading the tape. 


Figure 2-8. Screen pattern before a taped program is located 
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Next, depress the PLAY button on the cassette player and watch the 
television screen. When you get to the place where you heard the hum on the 
tape, the pattern will change slightly. It will change again when you reach 
the 5-second silent period. Then, when you reach the beginning of the pre- 
vious screeching noise, the screen will begin to show a pattern of much more 
distinctive dark and light bands. Figure 2-9 is an example of the screen 
during this program-loading operation. The exact appearance of the screen 
will depend on the television settings and the program that is being read. 

If you don't see these changes in the pattern, turn up the volume on the 
cassette recorder until you do. If you still don't see them, check to make sure 
thatthe cable is connected to the EAR jack at both ends, that it is making good 
contact, and that there is nothing plugged into the mic jacks. Some cassette 
players make a better connection if you first push the plug in all the way, then 
pull it back out very slightly. 

Once you have the cassette player controls adjusted, you can go back and 
load the tape correctly, without interruptions. Rewind the cassette, press the 
BREAK key to get back to the ЇЙ cursor, enter the LOAD" " command again, and 
start the tape. This time let the player run until the video pattern stops. The 
display should return to normal, with the program ready for use. If the 
program was purchased, follow the instructions that came with it. If there 
are no instructions, simply press the RUN key (the same as the R key), followed 
by ENTER, 


Figure 2-9. Screen pattern while a taped program is being loaded 
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Labeling Your Programs 


After using your computer for a few daysor weeks, you will probably have 
many different program tapes. If you don't make labels for the cassettes, you 
can quickly lose track of what you have and which tapea particular program 
is on. To avoid this, each time you save a program on a cassette, label the 
cassette with the name of the program. It's also a good idea to include the tape 
counter reading and a short description of what the program does. 


Caring for Cassettes 


If a music cassette gets a little bit of dust on it, or if you accidentally touch 
the recording surface of the tape, you won't notice the small change in the 
way the music sounds. But cassettes are really very delicate, and even this 
small amount of damage can completely ruin a computer program stored on 
atape. So becareful to rewind the cassette and put it back into its protective 
case when you are through with it. Don't touch the tape surface itself, and 
keep the cassette away from motors, kitchen appliances, and any other 
source of magnetic fields. 

Because tapes can be damaged despite your precautions, record your 
programs twice, using different tapes. That way you will have a backup copy 
if one of them gets damaged. 


Write-Protecting Cassettes 


You will probably use several different cassettes with your TS1000 or 
ZX81. Some cassettes will be “scratch” cassettes, used to make temporary 
copies of new programs while you are first writing or testing them. Others 
will have finished programs that you want to keep indefinitely. To prevent 
anyone (including yourself) from accidentally destroying one of the pro- 
grams, you can write-protect them. 

Figure 2-10 shows the write-protect notches on a cassette. New cassettes 
have plugs in the notches so that you can record on thetape. There is one notch 
for each side of the tape. To determine which tab is the correct one for the side 
that you want to protect, hold the cassette so that the exposed tape is away 
from you and the desired side of the cassette is facing up. The tab on the right 
side corresponds to the side that is facing up (Figure 2-10). After you have 
recorded the permanent version of a program you want to keep, simply 
punch out the tab for that side of the cassette. 

Most recorders are able to detect a missing tab and will not record on a 
cassette that is protected in this way. It would be a good idea, though, to 
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Write-protect notches 


Figure 2-10. Write-protect notches on cassette tape 


write-protect a scratch tape and try writing onto it, just to make sure that 
your recorder has this feature. 

If you change your mind and decide to record onto a cassette that you 
previously protected, you can always unprotect it by covering the notch with 
adhesive tape.? 


USING A PRINTER 


The printer is an optional accessory for the TS1000 or ZX81. It is not 
required for the computer to work properly, but it does provide a convenient 
way of making listings of programs, printing out the results of calculations, 
or making permanent graphs or pictures. Although several different print- 
ers are available, this book will describe only two: the Timex 2040 (available 
in the USA) and the Sinclair ZX (available in Canada and Europe). If you 
choose a different printer, make sure it is advertised specifically for use with 
the TS1000 or ZX81, and follow the manufacturer's instructions to use it. 
There are hundreds of printers on the market. Don't assumethat one of them 
will work with the TS1000 or ZX81 unless the manufacturer says it will. 

If your system includes a Timex 2040 or Sinclair ZX printer, plug it into 
theexpansion interface at the back of the computer. Remember to disconnect 
the power first to avoid damaging the computer or the printer. 

The ZX printer uses rolls of a special metallized paper. The 2040 printer 
uses а special thermal paper. Neither printer will work with ordinary paper. 


2 Lon Poole, Martin McNiff, and Steven Cook, A pple II User's Guide (Berkeley: Osborne/McGraw-Hill, 1981), 
p. 20. 


26 The ZX81/TS1000 Home Computer Book 


You can use the program you entered earlier in this chapter to try out the 
printer. Once the program is in the computer, just press LLIST (SHIFT-G), 
followed by ENTER, and watch the printer print a copy of the program. With 
the ZX printer, don't worry if the printer is fairly noisy and the screen 
flickers while printing is in progress. Both of these are perfectly normal. 
When the printer stops, use the button to advance the paper until the entire 
listing is out. Then tear the paper free against the notched plastic strip. You 
can also use the copy command (on thez key) to print a copy of whatever is on 
the screen at any time. 


USING THE 46K MEMORY PACK 


Figure 2-3 shows how to connect the 16K memory pack to the computer. If 
you have both the memory pack and the printer, use the edge connector to 
connect the printer to the computer instead. Then plug the memory pack into 
the printer's connector. 

The memory pack simply provides more read/write memory (RAM) for 
storing programs and data. You don't need any special instructions for using 
it, sincethe computer automatically determines how much memory it has. If 
you enter a program so long that it begins to fill up all the available memory, 
you will notice that the television display gets shorter and shorter, until only 
one line (or just part of one line) is visible at the top of the screen. With the 
memory pack, you can enter many more program lines before this begins to 
happen. 

With the memory pack attached, you may also notice & longer pause 
between the time when you plug in the power and the time when the 18 cursor 
first appears on the screen. The computer tests its memory during this pause, 
and with more memory, the testing takes a little longer. 

To verify that the memory pack is working correctly, enter the following 
line: 


PRINT PEER 16585+256+РЕЕК 16559 


This command prints out a number called RAMTOP, which tells how much 
memory the computer found when it did its memory test. With the memory 
pack attached, the number 32768 should appear. Without the memory pack, 
you should see either 18432 (for the TS1000, which has 2K of RAM) or 17408 
(for the ZX81, which has 1K of RAM). 
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n this chapter you will begin to learn how to give commands and write 

programs for your TS1000 or ZX81 computer. Like most personal com- 

puters today, your computer is designed to understand the program- 
ming language called BASIC. 

À programming language is a way of giving instructions to the computer. 
Each of these instructions (also called commands or statements) usually tells 
thecomputer to do one fairly simple operation, like adding numbers together 
or printing something on the screen. You can combine these simple instruc- 
tions in different ways to do many different kinds of things. 

Some books on programming begin by telling you everything about each of 
the different statements in the language first, and then giving you all the 
rules for combining the statements into programs. But the best way to learn 
about computer programming is not to memorize lists of statements and 
rules. It's much easier and more fun to start by trying out a few of the most 
useful commands and learning how to use them to make short programs. 
That's what this chapter is about. Later chapters will build your knowledge 
by adding more commands and combining them in different ways, and 
explaining particular topies, such as graphies and animation. Appendix A is 
acomplete summary of Sinclair BASIC. After you have learned about BASIC 
by running programs and writing some programs of your own, thesummary 
will make it easy to look up particular commands when you need them. 


ENTERING COMMANDS 


First, be sure you have set up your computer correctly. Chapter 2 tells you 
how to do this. It also tells you how to use the computer's keyboard to produce 
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the different kinds of symbols that you see on the keys. All of the special 
words that Sinclair BASIC uses appear on the keyboard. Don't try to type out 
the individual words for the commands; if you do, the display probably will 
not show the same thing that you typed, and the computer will not do what you 
meant it to do. If you're not sure how to enter all the different kinds of 
keyboard symbols, have another look at Chapter 2. 

Now make sure that the display screen looks like the picture in Figure 2-7. 
If it doesn't, unplug the power, wait a few seconds, and plug it back in. The # 
cursor tells you that the computer is ready for a BASIC command. 


Displaying Numbers and Text 


One of the necessary operations of a computer is to display numbers or 
words on the screen. Otherwise, there would be no way to tell whether the 
program did what it was supposed to do, or what answer it came up with 
when it was finished. 

To print a number on the screen, simply press the key with the word PRINT 
on it, then press a number key (such as 7), and finally press ENTER. The 
command says “PRINT 7,” and the computer does exactly that: it prints the 
number 7 on the screen. Here's how the screen should look before and after 
you press ENTER: 


Before pressing ENTER After pressing ENTER 


Every line of BASIC must end with the ENTER key; the computer waits for 
the ENTER before it tries to obey the command. This book doesn't use any 
special symbol for ENTER. Most of the time it will not even remind you to use 
it. So remember that the ENTER is necessary at the end of every line. 

Fortunately, the PRINT command can do more than just print asingle digit 
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on thescreen. Try each ofthe following commands, one at a time. Remember 
to end each line with ENTER. 


PRINT 1442 


PRINT 243 


As you can see, the computer knows all about positive and negative numbers 
and decimal fractions, and it can do arithmetic. (There's a limit to how big 
the numbers ean be, but the limit is so large that you usually don't have to 
worry about it.) You can also instruct the computer to print at a particular 
place on the screen, or to print numbers in neat columns on successive lines. 
Chapter 5 will tell you how. 

Numbers are not the only things that you can ask the computer to display 
on thetelevision screen. In fact, it will display any lineoftext that you want it 
to display. All you have to do is to put quotation marks around thetext and use 
a PRINT command, like this: 

PRINT "І CAN DISPLAY ANYTHING vo 

М WAHT МЕ TO" 


Type this line now. Remember to use the special PRINT key and to use the 
SHIFT key for the quotation marks. Of course you will have to type out the 
words between the quotation marks, one letter at a time. When you press 
ENTER at the end, the computer displays exactly what was between the 
quotes, like this: 


PRINT "I CAN DISPLAY ANYTHING vo 
U WANT МЕ TO" 
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You will find many uses for PRINT statements like the one just given. If 
you write a program that balances your checkbook, computes compound 
interest, or calculates numbers for any other reason, you will probably want 
the computer to print sometext along with the numbers that it calculates, in 
order to show clearly what each number is. If you write a program to display 
& chess board or to play an animated game, you will use PRINT statements 
with graphics characters between the quotation marks to draw the chess 
pieces or animated objects on the screen. 

You might like to experiment a bit with the PRINT statement. Make sure 
you remember how to produce the graphics characters on the screen (see 
Chapter 2). Then try putting some of them into a PRINT statement. 

If your system includes the Timex 2040 or Sinclair ZX printer, you can also 
experiment with the LPRINT command (SHIFT-S). LPRINT works exactly the 
same way as PRINT, except that it prints on the printer instead of the televi- 
sion screen. 


The Computer as Calculator 


Now that you know how to use the PRINT statement, you can do anything 
with the computer that you can do with a pocket calculator. Just enter the 
PRINT command followed by an expression that tells what calculations you 
want done. The computer will print the answer. For example, suppose you are 
balancing your checkbook, and you want to add a deposit and subtract a 
couple of withdrawals. Here is how you might do it: 


PRINT 495, 234+200-3,295-14,79 


The computer prints 677.49, the correct result. 

АП of the usual operations of arithmetic — addition, subtraction, multipli- 
cation, division, and exponents —are available on the TS1000 or ZX81. How- 
ever, the symbols that represent some of them may be a little different from 
what you are accustomed to. The symbols for addition (+) and subtraction (-) 
are just what you would expect. The symbol for division is a slash (/), and the 
symbol for multiplication is an asterisk (+). Exponents are denoted by a 
double asterisk (++). Notice that this double asterisk is a single symbol, which 
you get by shifting the H key. Do not try to type two single asterisks instead; 
think of +. as a completely separate symbol. 

To illustrate the different arithmetic operations that you can do with the 
TS1000 or 2Х 81, enter the following lines: 


PRINT 7418 


FRINT 1000-1.= 
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PRINT 6412 


PRINT 365-12 


PRINT 8443 


The correct answers are 17, 998.8, 72, 30.416667, and 512. Table 3-1 covers all 
of the standard arithmetic operations. 

You can also combine several different operations in a single line, as long as 
you make sure the computer understands what you mean. Consider the 
following command: 


PRINT 1546.3 
There are two different ways that you could interpret this command: 


a. 15+6=21 b. 6/3=2 
21/3=7 15* 2-17 


It could mean to add 15 and 6, then divide the result by 3. That would give an 
answer of 7, as shown on the left. It also could mean to divide 6 by 3 (giving 2) 
and adding the result (2) to 15. In that case you would get a final answer of 17, 
as shown on the right. How is the computer supposed to know which one of 
these two you mean? 

To solve this problem, the computer assigns a priority to each different 
type of arithmetic operation. The ** орегай оп has the highest priority, which 
means that it is done first, before any of theother operations in the command 
are considered. Next in priority come the «and /operations, followed by + and 
—. So in the example above, the division 6/3 will be done first, because division 
has a higher priority than addition. The result of the division (2) is then 
added to 15, to give 17. Try it and verify that the computer gives 17 as the 
answer. Table 3-2 shows the priority levels for arithmetic operations. 

What if you want things done in the opposite order? Suppose you want the 


Table 3-1. Arithmetic Operators 


Symbol Operation 


+ Addition 

= Subtraction 

* Multiplication 
/ Division 

«ж Exponentiation 
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Table 3-2. Priority of Arithmetic Operations 


Symbol Meaning Priority 
Ы Exponentiation Highest 

*/ Multiplication, Division Middle 
To Addition, Subtraction Lowest 


computer to add 15 and 6 and then divide the result by 3. You can get it to do 
this by putting 15+6 in parentheses, like this: 


PRINT 115481 £3 


When the computer sees parentheses in such a command, it calculates 
whatever is inside the parentheses first, regardless of what priority the 
operation would otherwise have. Then it takes the result and combines it with 
the rest of the expression outside the parentheses to get the final answer. 

You can even have parentheses inside of parentheses, as many times as you 
need to. The computer will evaluate the expression inside the innermost set of 
parentheses first. Then it will combine that result with the numbers in the 
next set of parentheses, and so on. For example, consider the command 


PRINT (115451 31 +»2 


The computer first adds 15 and 6 in the innermost parentheses, getting 21. 
Then it divides 21 by 3, getting 7. Finally, it squares 7 to get the correct 
answer, 49, 

What do you think the computer would print if you left out all the paren- 
theses and just gave the command 


PRINT 15+8:<3*%%2 


Use the table of priorities given above to figure out what would happen. Then 
enter the command and see if you get what you expected. 

Incidentally, one of the most common errors that any programmer makes 
is to lose track of the parentheses in an expression. If you are writing a very 
long expression, such as 


PRIWT (15416 (2-(2344¢(3-(54 (2451 


“... .” 
) 


it's easy to leave out a 4” or a “y” symbol, or to put in an extra one. Since 
parentheses always come in pairs, the number of left parentheses must 
always bethesame as the number of right parentheses. If not, the expression 
just doesn't make sense, and the computer has no way of knowing what you 
really meant. In that case, it displays its E cursor and gives you a chance to 
change the expression. 
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Using Names for Numbers 


Of course, your TS1000 or ZX81 is much more than just a calculator. Even а 
programmable calculator cannot begin to compete in power and flexibility 
with a full-fledged computer. One of the most important advantages of a 
computer over a calculator is the computer's ability to store a great many 
numbers (or other kinds of information) in its memory. Most calculators have 
at least one memory location where you can store a number that you have 
calculated for later use. Some calculators have several such memory loca- 
tions. The TS1000, even without the added memory expansion, can store 
several hundred numbers at a time. 

The examples in the previous section simply printed the result of a calcula- 
tion as soon as the calculation was finished. In this section you will learn how 
to save and recall numbers from computer memory. 

The BASIC language makes it very easy to save and use a number in 
memory, just by giving thenumber a name. The BASIC command that stores 
a number and gives it a name at the same time is the word LET. You use it like 
this: 


LET MYNUMEER=7 


This statement tells the computer to store the number 7 and giveitthe name 
MYNUMBER. After the computer receives this command, you can use 
MYNUMBER in exactly the same way you would the number 7 itself. For 
example, if you now enter the command 


PRINT HYHUMEER 
the computer will print 7. If you enter 
PRINT MYHUMBER+9 


it will print 16, and so on. 

The nameof a number can be any combination of letters and numbers that 
you want to use, as long as the first one is a letter. For example, you could call a 
number DRIVERSLICENSENUMBER, or MAY31PAYMENT, or you could 
use asingle letter, like Q or A. The computer will reject a name like 4THOF- 
JULY, however, because it begins with a number instead of a letter. 

You can also re-use the same name for a different number, just by writing 
another LET statement, such as: 


LET MYNUMBER=365.5 


If you do this, the old number will be discarded, unless you have saved it by 
giving it another name. 
The “name” of the number is called a variable, and the number itself is the 
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value of the variable. In the example above, we would say that the variable 
MYNUMBER has the value 365.5. Think of the variable as if it were a box 
with thelabel MYNUMBER on it. You can put any number into the box, and 
the new number that you put in replaces the number that was there before. 
The computer's memory would look something like this: 


TS1000 е 


ШТА то шй 
o 7 \ 
[So A AA 


IMYNUME E 


TEM 
SSS 


You can have hundreds of different boxes, each with a different name, and 
you can use the name in a calculation just as you would use the number itself. 

The ability to use variables like this provides three important advantages. 
First, it is possible to store numbers and retrieve them for later use. Second, 
it is easy to keep track of all the different numbers you may be using, since 
you can give each number a name that reminds you what the number is being 
used for. Third, when you use a number more than once, your program will 
require less memory if you use a variable instead of retyping the number 
itself. 


AN EXAMPLE OF USING VARIABLES 


An example will show how variables can make a calculation easier. Sup- 
pose you have $100 invested in a savings account that pays interest at an 
annual rate of 10%, compounded quarterly. You want to calculate how much 
will be in the account after half a year (two quarters). To do this calculation, 
you could begin by defining variables for the principal and the interest rate, 
like this: 


LET PRINCIPAL=100 

LET RATE=4.10 

LET QRATE=RATE 74. 
The computer doesn’t care what you call the variables, but it's a good idea to 
use names, such as PRINCIPAL and RATE, that describe what the variables 


mean. Thethird statement also defines a new variable called QRATE, which 
is the interest rate per quarter. 
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Now we calculate the interest for the first quarter and add it to the 
principal, to get the new worth of the account after the first quarter: 


LET UlINTEREST-züRRTEsPRINCIPHL 
LET GiuORTHzPRIHCIPRHL-«ülIINTEREST 


By calling the first quarter interest QIINTEREST and the new worth 
Q1WORTH, we use the variable names to help us remember what the vari- 
ables mean. Now we take the new worth, calculate the interest on it for the 
second quarter, and add it to get Q2WORTH, the total worth at the end of the 
second quarter. This is the answer we wanted to calculate, and we ask the 
computer to print it: 


LET Q2INTEREST =GRATE¢G1UORTH 
LET DEUORTH=01LORTH+02 INTEREST 
PRINT G2UORTH 


You might like to enter this calculation into the computer, for practice. 
Enter each of the eight lines in order, exactly as they appear above. Use the 
single-key entry for the command LET, but type the variable names letter by 
letter; there are no special single-key entries for variable names. Be very 
careful to enter the names exactly the same way each time. If you enter the 
statements without any errors, you will get the answer 105.0625. 


RULES FOR VARIABLES 
You must follow three rules in order to use variables correctly: 


1. Between LET and the equal sign there must be one variable name, and 
nothing else. 
For example, both of the following statements are illegal. The com- 
puter will reporta syntax error (by displaying the В cursor) if you try to 
enter them: 


LET A+B=35 
LET 17=ABLC 


The first statement is illegal because there is more than one variable 
name on the left of the equal sign. The second statement is illegal 
because the number 17 on the left is not a variable. (A variable must 
begin with a letter, not a number.) 

This rule makes sense if you remember what the LET statement does: 
it gives a value to the variable that is to the left of the equal sign. 
Therefore there must be a variable in that position. 
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2. You have to define a variable before you can use it on the right side of the 
equal sign, in a PRINT statement, or anywhere else. 

Another way of stating this rule is that a. variable must appear on the 
left sidenf a Ler statement а let once before tcm appear ante 

else. (Actually, the INPUT statement can define variables “but we will 
save that for later.) 

If you try to use an undefined variable, the computer will print the 
error code 2 in the lower left-hand corner of the screen and will not 
proceed with the calculation. There's no way it could go on under those 
circumstances. Remember that a variable is like a box with a number 
(its value) in it. When you use a variable on the left side of a LET 
statement, you are telling the computer what to put into that box. When 
you use a variable on the right side of a LET statement, you are telling the 
computer to use the number that is in that box. Using an undefined 
variable on the right is like asking the computer to use the number from 
an empty box. Since there is nothing there to use, the computer simply 
tells you that you made an error and waits for further instructions. 


e» 


Once you have defined a variable, you can change its value as many 
times as you want, using LETstatements. The variable name never goes 
away unless you unplug the power or execute NEW, LOAD, RUN, or CLEAR. 

A LET statement is not the same as an equation in mathematics. At 
first glance, a LET statement looks very similar to an equation in arith- 
metic or algebra. For example, the statement 


LET х=у+2 
looks very much like the equation 
х=у+8 


The two are quite different, however. The LET statement is a com- 
mand. It tells the computer to perform a specific action: "Take the | 
number that is in box Y and add 3 to it, then put the resulting number in \ 
box X." On the other hand, the algebraic equation x = y + 3 is not a 
command at all. It merely states a relationship between x and y, and it 
doesn't tell anybody to do anything. 

BASIC does not use such equations. Every statement of BASIC is a 
command, telling the computer to do something. 

The distinction between mathematical equations and BASIC com- 
mands is very important. In mathematics, the equation 


x=xt+1 
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would have to be a mistake. No number remains the same when you add 1 to 
it. However, the BASIC command 


LET ЕЖУ 


is perfectly legal. It instructs the computer to take the number that is in 
the *box" called x, add 1 to it, and put the resulting value back into the 
*box" called x. Statements like this are very common in BASIC. 


To show how such a LET statement might be useful, let's return to the 
example of a compound interest calculation. Originally, we used a different 
variable for each quarter's interest and for the new valueof the investment at 
the end of each quarter. The statements to perform the calculation looked like 


this: 


EET 
LET 
LET 
LET 
LET 
LET 
БЕТ 


PRINCIPAL сійе 

RATE=8.,10 

ORATESRATE 74 
Q1INTEREST=0RATEFPRINCIPAL 
DIVORTH=PRINCIPAL+01INTEREST 
UZINTEREST-üHHTExülUORTH 
GEVORTHSOLUORTH+RD2 INTEREST 


PRINT G2UuORTH 


Now we will do the same calculation in a different way, using a single 
variable, INTEREST, each time we calculate a quarter’s interest, and using 
a single variable, WORTH, to store a running total of the principal plus 
interest to date. The INTEREST and WORTH from the previous quarter get 
replaced by the current INTEREST and WORTH. That’s all right because 
by the time we are ready to calculate these values for the next quarter, we are 
finished with the old values from the previous quarter. Here’s how we could 


do it: 


LET 
LET 
LET 
ШЕТ 
LET 


UORTHz18G8 

RATE=0, 10 
QRATESRATE <4 
INTEREST =GRATESUORTH 
WORTH SWORTH+INTEREST 
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LET INTEREST =GRATESWORTH 
LET WORTHSWORTH+INTEREST 
PRINT WORTH 


Again, you might like to try entering these statements. They should give the 
same answer as the first version, 105.0625. 

The second version is simpler and easier to follow than the first version. It 
also uses fewer variables and therefore takes up less of the computer’s 
memory, but both give exactly the same result. You will see this example 
program again in Chapter 4, where you will learn how to use some of the 
other features of BASIC to simplify it even further. 


WRITING AND RUNNING PROGRAMS 


The rest of this book is mainly about how to write computer programs for 
the TS1000 and ZX81. This section tells you more specifically what a comput- 
er program is and how to ENTER, EDIT, RUN, and SAVE the programs that you 
write. 


Commands Versus Programs 


Until now, all of the examples in this book have been single-line commands, 
such as 


РАТЫТ "THIS ІЗ A SINGLE-LINE СОМ 
HAND” 


This mode of operation is called command mode or immediate mode. You 
ENTER the commands one at a time, and the computer executes each one as 
soon as you enter it. The computer “remembers” variables you create in this 
mode (using LET statements), but it “forgets” the commands themselves as 
soon as it has executed them. In command mode, you cannot tell the computer 
to back up three commands, for example, and execute one of the previous 
commands a second time. If you want to do that in command mode, you have 
to enter the whole command again. Command mode is useful when you just 
want to do a simple calculation or try out a new kind of BASIC statement to 
see how it works. 

Often, though, you will want to do more than that. You may need to give the 
computer a list of several commands to remember, so that you can ask it to do 
allofthe commands on the list again, in order, whenever you need them. Also, 
suppose you make a mistake typing in a command line but fail to notice the 
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mistake until several lines later, when you get a wrong answer or an error 
message. It would be better if you could keep all the lines there on the screen, 
go back and changeone of them when you need to, and then run the whole set 
of commands again. 

The compound interest example in the previous section illustrates this 
need. If you made any errors while entering the commands, or if you occa- 
sionally lost track of where you were in the sequence of command lines, you 
will understand some of the limitations of the single-line command mode. 

The ability to keep, edit, and rerun aset of commands is a standard feature 
of the BASIC language. Such a list of commands is a computer program, and 
this mode of operation is called programmed mode. Once you have entered a 
program, you can change parts of it or add more commands to it without 
having to retype the whole program. You also can list the program on the 
screen or save it on cassette tape to load back in whenever you want to use it 
again. 

In the following sections, you will learn how to enter programs, edit them, 
run them, and save and load them on cassette tape. You will also learn some 
important facts about how computers and computer programs work. 


Entering Programs 


Entering a program line is almost exactly like entering a single command. 
The only difference is that the program has a line number in front of it, like 
this: 

ла PRINT "THIS 15 THE FIRST LI 

НЕ OF A FEUGRBRH' 

Enter the line exactly as it appears above. You don't have to press the SPACE 
key between 10and PRINT, or between PRINT and the first quotation mark. The 


computer will put those spaces in automatically, but you do have to type 
spaces between the words in quotation marks. 
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Press the ENTER key, as usual, when you get to the end of the line. The 
television screen should now look like this: 


Та кїт "THIS 15 THE FIRST LI 
НЕ OF A PROGRAM" 


Notice that the computer did not execute the command. Instead, itjust wrote 
the line at the top of the screen and left it there. It did this because the line had 
a number at the beginning, before the BASIC command word. The line has 
now become the first line of a program. 

Next, enter the command RUN. (The command is on the same key as the 
letter R. Don't try to type out the word RUN.) Now the screen should look like 
this: 


THIS ІЗ THE FIRST LINE OF A FROG 
ВАН 


When you enter the RUN command, the TS1000 ог ZX81 executes the pro- 
gram that you have entered into its memory. Since this program has only one 
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line, the result is exactly the same as if you had entered the line as a 
command, without a number. But the program line is still there. Enter the 
command LisT (on the к key) and you will see it. You can RUN it again, as many 
times as you like, and the result will always be the same. 

Of course, most computer programs have more than one line. To enter a 
second line, just use a larger line number: 


ва PRINT "THIS ІЗ THE LAST LIN 
E" 


Here is how the screen will look after you have entered line 20: 


18 PRINT “THIS 15 THE FIRST LI 
NE OF A PROGRAM” 

2E IT "THIS ІС THE LAST LIN 
E" 


If you enter RUN now, the computer will first execute line 10, and then line 20. 
The screen will look like this: 


THIS 13 THE FIRST LINE OF A PROG 
RAH 
THIS 15 THE LAST LINE 
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Now enter LIST to see the program listing again. 

Every program line must have a line number, and there can be only one 
command per line. 

The computer knows which line to execute first. It begins with the one that 
has the lowest line number, then it executes the next lowest, and so on. (You 
can also tell it to skip around, but we will save that topic for a later chapter.) It 
doesn't matter in what order you actually entered the different lines. The 
computer will use the line numbers to reorder the lines for you. To see how _ 
this works, enter the following line: 


15 PRINT "THIS ІЗ THE HIDDLE L 
IHE" 


Although line 15 was entered last, the computer lists the lines in numerical 
order, with 10 at the top, 15 in the middle, and 20 at the end. If you enter RUN 
now, the computer will execute the three lines in that order. 

It's always a good idea to number your program lines in steps of 10 or more, 
so that you can go back and insert new lines between them if you want to. 


THE NEW AND CLEAR COMMANDS AN 


Suppose you have entered and run a program, and now you are through 
with it and ready to enter something new. One way to get rid of the old 
program would be to delete each of its lines, one at a time, but that would not 
get rid of the variables that the old program defined. They would still be in 
memory, using up valuable space. You could unplug and reconnect power, but 
that is hard on the computer. Fortunately, BASIC provides a command that 
removes a program and its variables from memory. It is the NEW command, 
located on the A key. There is also a CLEAR command (on the x key) that gets 
rid of all the variables without deleting the program. 


THE REM STATEMENT 


The REM command tells the computer nothing but to go on to the next 
line — yet it is one of the most useful commands on the keyboard. 
Execute NEW, then enter the line 


ла РЕМ THIS IS A REMARK 


Now enter RUN. Nothing special happens. 

What the REM statement does is give you a chance to put comments 
(REMarks)in your program so that you and other people can more easily see 
and remember how the program works. Putting in REM statements may 
Seem like a waste of time, but the opposite is true. It is a waste of time not to 
put in REM statements, because you will spend so much more time later on, 
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maybe even months later, when you decide you would like to improve the 
program but can't remember how it works. Get in the habit of using REM 
statements from the time you begin learning BASIC. 


SLOW AND FAST MODES 


By now you have probably noticed that the computer cannot keep up with 
you if you try to type very fast. Every time you press a key, you haveto wait for 
the computer to display the entire line you were typing, one character at a 
time, from left to right on the television screen. Évery time you press ENTER 
at the end of a new program line, you have to wait for the computer to 
redisplay every program line on the screen, from the top down. As your 
program gets longer, you will notice these effects even more. 

The reason the computer's response seems so slow is that it has more to do 
than just follow what you are doing at the keyboard. It also has to generate the 
video signal that goes to the television set. Because of the way a television 
works, the computer cannot just send characters to the screen. In fact, it must 
keep sending every line of the television picture, from top to bottom, 60 times 
every second (or in Europe, 50 times every second). This actually takes up a 
great deal of its time, but the computer still uses the time between video 
frames to respond to what you are typing or to run your program. The 
designers of the ZX81 апа TS1000 made them this way so that the programs 
can change the television display while they are running to produce ani- 
mated effects. Without this capability, most computer games would be rather 
dull, and the computer would not be nearly as useful in many other ways. 

Sometimes you don't really need to see the display all the time, and you 
would rather have the computer run faster. That's what the FAST command 
(SHIFT-F) is for. Press FAST, followed by ENTER, and then retype one of the lines 
you entered above. Now the computer will respond much faster to what you 
type, but you will not see the individual letters of the line appearing one at à 
time after each keystroke. Instead, the screen will go blank momentarily 
when you press a key, and then the entire display, with the new character in 
it, will reappear all at once. 

To reset the computer to the mode it was in before, enter SLOW (SHIFT-D). 

When you first plug in the computer, it is in 81.0% mode. It goes into FAST 
mode automatieally when you save or load a program from cassette, or when 
you print on the printer. Then when it finishes, it goes back into SLOW mode 
again. 

You can use FAST and sLow as single-line commands, or you can use them as 
program lines. Most people prefer to put the computer into FAST mode when 
they are entering programs, and to use sLow mode only when they are 
running programs that do animation. The first program that you entered in 
Chapter 2 is an example of animation. If you run it in SLow mode, you willsee 


ns 2 2 _ _ == 22 = 
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the letter I moving in across the screen from the right, and then up the screen 
from the bottom. If you run the same program in FAST mode, you will not see 
the letter I move at all. The screen will be blank for a short time, and you will 
only see the final result, with the I in place at the top of the screen. 


WHEN MEMORY GETS FULL 


Without the 16K memory pack, both the TS1000 and the ZX81 have a 
rather small amount of memory available for storing programs and data. 
With the ZX81 you can enter about 20 or 30 program lines (depending on 
what the lines contain) before memory gets full. With the TS1000 you can 
enter between two and three times that many lines. 

As memory gets close to being completely full, the display will begin to 
behave strangely. Try entering the same line over and over again with 
different line numbers in order to see what happens. Any one of the lines you 
entered above will do. (If your system has the 16K memory pack, unplug 
power and remove the pack first; otherwise you will have to enter hundreds of 
lines to fill up memory, and the effect on the display will be slightly different.) 

The first thing you will notice as memory fills up is that the program listing 
begins to move up, leaving a blank space at the bottom of the screen. This 
happens because the screen display also uses up part of the computer's 
memory, and the computer was designed to take memory away from the 
display area if necessary in order to make more room for your program. If 
you keep entering more lines, the display will eventually shrink to nothing, 
except for maybe a few characters at the very top. The program is still there, 
however, and you can see it again if you DELETE some of the lines you have 
entered. (To delete a line, just type its line number, followed by ENTER.) 

Other strange things may also happen as the memory gets full. The EDIT 
key may fail to work. If you try to run a program, it will probably stop before 
it should. The numeral 4 will appear at the lower left-hand corner of the 
screen. This number is an error code that tells you that you have run out of 
memory. 

There isn't much you can do when memory gets full, except to delete part of 
the program. You will probably want to delete REM statements first. It also 
helps to useshort names for variables and to use variables instead of numbers 
whenever you can. Beyond this, the only thing you can do is obtain the 16K 
memory pack accessory. 


Editing Programs 
There are two reasons why you might want to change parts of a computer 


program. First, you might need to correct a mistake made when you first 
entered the program. Second, you might decide to make some changes in 
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what the program does. In either case, you will need a way to edit your 
computer programs. 

The TS1000 and ZX81 computers have several special editing keys and 
other features to help you make changes in your programs. These features 
include whole-line editing, the DELETE key, the horizontal and vertical arrow 
keys, and the EDIT key. The following sections describe these features. 


WHOLE-LINE EDITING 


You have already learned how to insert a new program line into a program. 
Just type a line number that corresponds to the place in the program where 
you want to insert the line, followed by the new line itself BASIC will 
automatically insert the line in the right place for you. You can also change an 
existing line by retyping it with the changes, using thesame line number. To 
illustrate this, first retype the lines given in the section on Entering Pro- 
grams, earlier in this chapter, so that the television screen looks like this: 


іс PRINT "THIS ІЗ THE FIRST LI 
HE OF A PROGRAM” 

15 PRINT "THIS ІЗ THE MIDELE L 
INE" 

га PRINT “THIS 13 THE LAST LINH 
E" 


Now enter the following: 
15 PRINT "ЧЕЧ MIDDLE LINE” 


You will see that the new line 15 replaces the old line 15 that you entered 
before. You can even erase a line entirely by typing just its line number, 
followed by ENTER. Try this for line 15, and watch the line disappear from the 
display. 


THE DELETE KEY 


The DELETE key (sHIFT-0) deletes the character to the left of the cursor on 
the screen. Use this key to back up and correct an error any time while you 
are typing a line. Type a few characters. Then DELETE them to see how the 
DELETE key works. Notice what happens when you have deleted everything 
up to the left-hand edge of the screen. The DELETE key now has no further 
effect. If you want to change something on a previous line in programmed 
mode, you must either re-enter the whole line or use the EDIT key (explained 
later in the chapter). 
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THE CURSOR LEFT AND CURSOR RIGHT KEYS 
(SHIFT-5 AND SHIFT-8) 


Use the — and — keys to move the cursor backward or forward on the line 
you are typing. You can insert additional characters anywhere in the line by 
moving the cursor to the right place and entering the new characters. For 
example, suppose you have just typed a line that looks like this: 


15 PRINT "NEL MICLE LINE" 


The Y cursor appears at the right end of the line because you have not yet 
pressed ENTER. Use the — key to move the cursor back until the linelooks like 
this: 


15 PRINT "NEU МІСЕ LINE" 


Now type the second D, followed by ENTER. The corrected line will appear 
in the program listing. Notice that you can use ENTER at any time, regardless 
of where the cursor is within the line. 

To delete a character in the middle of a line, use the CURSOR LEFT or RIGHT 
key to position the & cursor immediately to the right of the character you 
want to delete. Then press DELETE. You can move back and forth within a line 
as many times as you like, inserting and deleting characters. The — and — 
keys are especially useful for correcting errors that the computer detects and 
marks with the E cursor. 


THE EDIT AND CURSOR UP AND CURSOR DOWN KEYS 


The editing techniques in the last two sections apply only within a single 
line, before you press ENTER. To edit a line that is already entered, you first 
have to select which line to edit. You may have noticed that the symbol 
often appears on one of the program lines, between the line number and the 
command word. This symbol is the edit cursor. You use it to select a line for 
editing. 

To use this editing method, first make sure the screen looks like this: 

ла PRINT "THIS ІЗ THE FIRST LINE 

OF A PROGRAM" 


ISMPRINT "NEU OMICOLE LINE" 
за PRINT "THIS IS THE LAST LINE" 


The edit cursor may be on line 10 or line 20 instead of line 15, depending on 
which line you entered last, but everything else should be the way it looks 
above. If it is not, re-enter the line or lines that are different. 

Now use the t and | keys (SHIFT-7 and SHIFT-6) to move the В cursor up and 
down on the screen. Move it to line 10 and press EDIT (SHIFT-1). А copy of line 10 
willappear at the bottom of the screen, where new lines ordinarily appear as 
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you type them. Now use the — and — keys to move back and forth in the line, 
inserting or deleting characters just as you would when entering a brand 
new line. To illustrate this editing method, change the copy of line 10 at the 
bottom of your program so that it reads: 


10 PRINT "NEU FIRST LINE" 


The original line 10 at the top of the screen remains unchanged until you 

press ENTER. Then the edited line at the bottom disappears, and a copy of it 

replaces the old line 10 at the top. Now the screen looks like this: 
1ӘШЕБІМТ "NEW FIRST LINE" 


15 PRINT “NEW HMIDDCLE LINE" 
га PRINT "THIS ІЗ THE LAST LINE” 


If your program is too large to fit on the screen, you can still use the ! or | 
key to move to any line. The computer will scroll thescreen up or down as the 
reaches the top or the bottom of the screen. However, if the computer's 
memory is so full that the television display begins to show less than a full 
screen, the EDIT key may not work. If this happens, you can still change the 
line by re-entering it. 

You can also move the B cursor up or down with the List command, 
followed by the number of the line where you want the edit cursor. Enter 


LIST 15 


and watch the В cursor move to line 15. Use this method with very long 
programs, when it would take too long to move the cursor from one end of the 
program to the other with the ! or the ! key. 

Table 3-3 contains a summary of the special editing keys. 


Error Codes 
You have probably noticed that a pair of numbers appears at the lower 


left-hand corner of the screen every time the computer executes a command 
or runs a program. This pair of numbers, separated by a slash (0/10, for 


Table 3-3. Editing Keys 


Keys Purpose 
DELETE Delete character to left of cursor 
— and — Move cursor left or right within current line 
t and! Move cursor up or down 
EDIT Bring the line marked by В to the bottom for editing 


рии 


50 The ZX81/TS1000 Home Computer Book 


example) is called a report code or an error code. It contains useful informa- 
tion about what happened while the command or program was executing. 
Always look at the report code after you run a program. 

The number to the right of the slash is the line number of the last line that 
the computer executed. A zero in this position means that the line was a 
single-line command, which has no line number at all. The number to the left 
of theslash tells you whether the computer detected any errors when it tried 
to obey the program instructions. À zero in this position means that no errors 
were detected. Other numbers usually mean that some kind of error oc- 
curred. The number to the right of the slash shows which line the computer 
was executing when it detected the error. You will learn more about the 
different kinds of errors and what to do about them in the following chapters. 
Appendix B lists all the possible error numbers and their meanings. 


Saving Programs on Tape 


In Chapter 2 you learned how to load a prerecorded program from a 
cassette into your computer. This section will tell you how to save a program 
of your own onto a cassette, so that you can load it back into the computer and 
execute it at a later time. You might want to go back and review the cassette 
section of Chapter 2, to make sure you remember everything that you learned 
there. 

First you need a program to save on tape. You can use the compound 
interest program that was given a few pages back, the introductory program 
from Chapter 2, or some other program that you have loaded from tape. Any 
program will do. With a program entered in the computer, use the jacks to 
connect the MIC plug on the computer (Figure 2-7) to the MIC or MICRO- 
PHONE plug on your cassette recorder. If the cable to the EAR plugs is still 
connected, unplug it in ease your recorder is the kind that will not work 
correctly with both plugs occupied. Place a blank eassette (or one whose 
contents you don't want to keep) in the recorder. 

Now type in the following command at the keyboard (use the s key for 
SAVE), but don't press the ENTER key yet: 


ЗАЧЕ "PROGRAMI" 


You can use any name you want between the quotes, instead of PROGRAM 1, 
but you must put a name of some kind there. Otherwise, the computer will 
refuse the command. The name you use is stored with the program. You will 
use it with the LoAD command later, when you are ready to read the program, 
to tell the computer which program to search for on the tape. 

Start the cassette recorder in RECORD mode (the instruetion manual for 
the recorder tells you how to do this). Wait until the tape has unwound past 


Chapter 3: Getting Started with BASIC 54 


the leader and onto the recording surface. If you can't see the leader clearly, 
just wait about ten seconds after starting the tape. 

Next, press ENTER on the computer keyboard, and watch the television 
display. The picture should go blank for five seconds. Then you will see a 
pattern of black and white lines, somewhat like the picture in Figure 3-1. 
This pattern means that the computer is recording your program. After a 
few seconds (the longer the program, the longer it takes), the screen will 
return to normal and the report code 0/0 will appear in the lower left-hand 
corner of the screen. Now stop the recorder. 

If this is the first time you have saved a program on a cassette with the 
TS1000, you should listen to the tape to make sure that the volume was at the 
right level, and that the recorded program is free of excessive noise. To do 
this, unplug the jacks from the cassette unit, rewind the tape, turn down the 
volume (to protect your ears), and play the tape. You should first hear a low 
hum, then five seconds of silence, and then a screeching noise that corre- 
sponds to the program itself. Turn up the volume until the noise is unplea- 
santly loud. Then rewind to the silent spot and make sure there is no signif- 
icant background noise where the silence should be. If there is, adjust the 
settings of the volume and tone controls whilesaving (if your cassette recorder 
has these controls). 

When you are satisfied with the quality of the recording, reconnect the 
EAR cable to the computer and load the program back in, following the 
instructions of Chapter 2. Enter the List command. The program listing on 
the screen should now look exactly the same as it did before you recorded it, 


Figure 3-1. Screen pattern while the cassette records a program. 


С 
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proving that you have found the right settings for the tone and volume 
controls. Mark the position of the controls on the dials so that you can find 
them again easily. 

You can record as many programs as you have room for on a single tape, 
one after the other. If you use a different name when you SAVE each one, you 
can LOAD any one of them back in by name without having to remember 
exactly where it is on the tape. If you ever forget the name of a program, use 
the command 


LORD 


with no name between the quotation marks. This command simply loads the 
next program on the tape, regardless of its name. 

If your cassette unit has a program counter, use it to keep track of where 
each program is on the tape. Use the FAST FORWARD mode of the cassette 
unit to go directly to the program you want, instead of waiting for the 
computer to search the whole tape. In order for this technique to work, you 
must remember to reset the counter each time you insert and rewind a 
different tape, whether to SAVE or to LOAD. When you SAVE a program, write 
the counter reading on the cassette label, beside the name of the program. 


Interrupting a Program 


Sometimes you may want to stop a program earlier than it would normally 
stop. For example, you might discover an error in your program and decide 
to stop it immediately instead of waiting for it to finish. Alternatively, the 
cassette unit might malfunction while loading or saving a program. 

The BREAK key stops the program and restores the 18 cursor immediately. 
The BREAK key is the same as the SPACE key. If you press it while you are 
entering a program, it inserts a space. If you press it while a program is 
running, however, it terminates the program and displays the 13 cursor. 


HOW PROGRAMS WORK 


In the previous sections you have learned what a computer program is. You 
have seen how to enter program lines and how to edit, run, and save BASIC 
programs using your TS1000 or ZX81 computer. You have also learned how to 
use some of the individual programming commands of the BASIC language. 
Table 3-4 summarizes the commands you have used up to now. 

In Chapters 4 and 5, you will meet quite a few more BASIC commands. 
Now that you have learned enough BASIC to work with, and before we delve 
further into the specifics of the language, it’s time to think more carefully 
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Table 3-4. BASIC Commands 


Command Meaning 
PRINT Print numbers or text on the video screen 
LPRINT Print numbers or text on the printer 
LET Create a variable and give it a value 
LIST List program lines on the video screen 
LLIST List program lines on the printer 
COPY Copy the television screen to the printer 
RUN Run the program 
SAVE Save a program on cassette tape 
LOAD Read a program from cassette tape 
SLOW Maintain the display while programs run 
FAST Run faster by letting the display go blank during program 

execution 

NEW Delete the program and its variables 
CLEAR Delete all variables, but keep the program 


BREAK Interrupt the program that is running 


about what a computer can do, about what a computer can't do, and about how 
it proceeds through a computer program. 


The Obedient, Stupid Servant 


The single most important fact to remember about computers is this: 
computers do exactly what their programs tell them to do. You often hear 
news reports about so-called “computer errors" —when a computer sends out 
an incorrect bill, for example, or almost fires a missile by mistake. In 
practically every case, however, these errors are really human errors. They 
happen because a programmer gave wrong instructions to the computer. 
Only very rarely does a computer fail to execute its program correctly, due to 
a breakdown in one of its electronic circuits. 

In one sense, computers are stupid. They have no idea what you want to do 
or why you want to do it. They simply do exactly as they аге told, regardless of 
the consequences. Even the very best programmers sometimes discover, to 
their dismay, that what they told the computer to do was different from what 
they meant for it to do. 

Imagine that you have a servant who obeys every command you give him, 
perfectly and without fail. Unfortunately, this servant is also very stupid. As 
a result, you have to be extremely careful about how you phrase your com- 
mands. If you tell him to “dust everything in the house," you may come back 
in a few minutes to find him dusting the pudding or the cat. What will he do if 
you tell him to dust the roses? Will hesprinkle insecticide on them, or will he 
get out the feather duster again? With such a servant, you would not want to 


<< 
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say, “Could you bring me the hammer?" He would probably answer, “Yes, I 
could,” and then stand there waiting for your next command. 

Programming a computer is somewhat like giving orders to our stupid 
servant. It's sometimes difficult to tell a computer exactly what we mean 
because we are used to dealing with people who know what we mean from the 
context, even if we aren't completely precise in the way we say it. 

Computer languages, however, deliberately rule outthe kind of ambiguity 
that occurs in an English word like dust. If you accidentally type the letter O 
instead of 0, or the number 1 instead of the letter I, the computer will not 
guess what you really meant. If you forget to tell the computer to print the 
answer at the end of a long calculation, the computer will not print it. It can’t 
look at the program and understand your purpose in writing it. All the 
computer can do is obey the instructions, one at a time. 

Computers are becoming easier for people to program and use. The BASIC 
language is much more “user friendly” than the first computer languages 
were. Computer scientists are working toward even friendlier ones. It will be 
a long time, however, before computers really begin to understand our 
ordinary ways of expressing ourselves. Until then, people who want to write 
programs for computers must learn to use special computer languages like 
BASIC, and to be completely clear and explicit in the instructions they give. 


Programs that Make Choices 


If computers are really stupid, you may wonder how they can design 
factories, manage finances, play chess, and do all the other kinds of things 
that computers do. Part of the answer is that complicated programs for tasks 
likethese are constructed from smaller, simpler units. The kinds of tasks that 
computers can do well are ones that reduce to simple, individual procedures 
for performing a single calculation or making a single decision. You have 
seen how to program your TS1000 or ZX81 to perform calculations and to 
print numbers and text. Now you will learn some of the ways of program- 
ming the computer to make choices. 

The kinds of choices that the computer can make are very simple ones. For 
example, it can compare two numbers to see if they are equal, or to see which 
is larger. It can also choose one action or another, depending on the result of 
the comparison. Chapter 6 will describe in detail the kinds of comparisons 
the computer can make. The present section gives only an overview of this 
decision-making capability. 

The following shows how the TS1000 or ZX81 makes choices. Enter NEW 
(SHIFT-A) to erase any previous programs. Then enter the following program 
lines: 

УӘ LET TEST=1 

aeg IF TEST=1 THEN PRINT "UNITY 
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0 IF TEST=2 THEM PRINT "DUALI 


E 


Don't type out the words IF and THEN. Use the v key and SHIFT-3 instead. 
Now enter RUN and observe what happens. The screen should look like this: 


UNITY 


The computer prints UNITY because TEST is equal to one, and it ignores 
the PRINT command in line 90 because TEST is not equal to two. Now change 
line 70 to read 


ТӘ LET TEST=2 


and RUN the program again. This time the screen looks like this: 


DUALITY 
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What do you suppose will happen if you give TEST a different value, such 
as three? Try it and see. 

This decision program is not very useful, but it illustrates an important 
aspect of computer programming. À larger program might have you enter 
the value of TEST from the keyboard each time you run it. In this way, the 
program could give you the choice of doing many different things, depending 
on the value you entered for TEST. Another program might first calculate 
the value of TEST, and then use it many lines later. In this way, you can get 
the computer to “remember” what happened earlier in the program. 
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his chapter describes how the computer stores and displays its two 

major types of data: numbers and text. It tells you how to use BASIC 

commands to create and manipulate both kinds of data and how to 
use the computer's special functions that make such manipulations easier 
and more powerful. 


HOW TO USE NUMBERS 


Chapter 3 introduced the five arithmetic operations that the TS1000 and 
ZX81 recognize. These operations are summarized in Table 4-1. Chapter 3 
also described how to combine these operations with numbers to produce new 
numbers. Now you will learn more about the rules for combining numbers 
and about the different ways of entering numbers into the computer. 


Table 4-1. Arithmetic Operations 
Symbol Operation 


+ Addition 

- Subtraction 

* Multiplication 

/ Division 

жж Exponentiation (powers) 
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Priority in Numeric Operatlons 


Recall that each operation has its own priority. The priority determines 
which operation the computer does first when you combine different oper- 
ations. 

Our previous list of arithmetic operations and their priorities is not quite 
complete, however, because the minus symbol (-) actually has two possible 
meanings. It normally occurs between two numbers and means subtraction, 
but it can also oceur with a single number, such as —2. The minus sign here 
cannot mean subtraction, because there is nothing on the left sideof thesign 
to subtract from. This is a unary minus sign, which simply specifies a nega- 
tive number. It is a unary operator because it goes with only one number. The 
other kind of minus sign (which means subtraction) is a binary operator 
because it goes with two numbers. The operators +, +, /, and «are also binary 
operators. 

The unary minus sign belongs in second place in the table of priorities, 
after exponentiation but before multiplication and division. A complete 
arithmetic priority chart is shown in Table 4-2. 

Because of these priorities, you can multiply and divide negative numbers 
without parentheses, like this: 


PRINT 64-6 


The result is —48. 

You must be careful, though, if you want to take a negative number to a 
power. If you have studied algebra, you know that the square of a negative 
number is always positive. However, since exponentiation has a higher prior- 
ity than the unary minus, if you give the following command, you will get —9 
instead of the positive 9 that you might expect: 


PRINT -3%++2 


Because + has higher priority, the computer evaluates 3**2 first, to get 9. 
Then it applies the unary minus sign to get —9. 
You might try to force a positive result by using parentheses, like this: 


PRINT i-Z2is*«Z 


However, when you execute this command, the computer just prints report 
code A (illegal argument). 

Since the computer is unable to perform exponential functions on negative 
numbers correctly, you will need to detect the polarity (+/-) in your programs 
and make the corrections yourself. 
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Table 4-2. Priority of Arithmetic Operations 


Symbol Meaning Priority 

БЫ Exponentiation Highest 

- Unary minus (negation) Second highest 
* and / Multiplication and Division Lower 
+ and — Addition and Subtraction Lowest 


Numeric Expressions 


A numeric expression simply specifies some numbers and how to combine 
them. Some examples of numeric expressions are 


PRINT 490.239+200-3, 95-14,7% 


PRINT 1115481 3 ++2 


The command PRINT is not part of the expression. It is used in these 
examples because it tells the computer to evaluate the expression and display 
the result. As the results you get indicate, when the computer evaluates a 
numeric expression, the result is always another number. 

A numeric expression can be used wherever you can use a number in a 
BASIC statement, except at the beginning of the line as a line number. If you 
try to enter an expression for a line number, like this: 


243 PRINT "Во мат TRY THIS" 


the computer displays the E cursor and refuses to accept the line. 

You can use variables as well as numbers in numeric expressions, as long as 
you have defined each variable (that is, given it a value) beforehand. For 
example, if you have entered the command 


LET UARIABLEL=S 
then you can use VARIABLEL in an expression, like this: 


ЕБІМТ UREIRHBLE1-z 


Varlables and Constants 


The computer recognizes two different ways of specifying a number in an 
expression: the number itself, or a variable that has that number as its value. 
The number itself is a constant. Unlike a variable, it can never take on a 
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different value. Table 4-3 lists examples of numeric constants and numeric 
variables, showing the differences. 

Remember that the name of a i numeric variable must begin with a letter. | 
After that, it can contain any mixturé of letters and numbers. It cannot 
contain symbols, such as $, %, or “, however. 

A constant must begin with a digit, a decimal point, or a minus sign. If a 
number has no decimal part (for example, the number 7)the decimal point is 
optional. The computer treats the constants 7.0, 7, and 7. exactly alike. 

Constants generally look and act just like ordinary numbers, with two 
exceptions. First, the computer will not understand a number with commas 
in it, such as 32,768. You must use 32768 instead. Second, the computer will 
not accept a constant with a plus sign in front of it, such as +4.6, at the 


beginning of an expression. 
Scientific Notatlon 


Look at the number 1.67E —5 in Table 4-3. The name for this way of writing 
a constant is scientific notation. Scientific notation provides a convenient way 
of entering very largeor very small constants. Suppose you wanted to enter a 
large constant, such as 


7300000000000000 1 


Using ordinary notation, you could easily enter the wrong number of zeros by 
mistake. Scientific notation provides a better way of writing it. To use 
scientific notation, first move the decimal point so it is immediately to the 
right of the first (leftmost) nonzero digit. Remove all of the zeros after it. 
Then put an E after the number, followed by the number of places that you 
moved the decimal point. 

Using this procedure, 7300000000000000 would become 


7.8Е +15 


Table 4-3. Examples of Constants 
and Variables 


Constants Variables 


7 MYNUMBER 
3.1415927 MINCEMEAT 
—44.1 MAY31PAYMENT 
.25 VARIABLE1 


1.67E-5 D2K 
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In other words, 7.3E+15 means 73 followed by 14 zeros. The E serves as a 
separator between the first part (7.3), which tells what the nonzero digits of 
the number are, and the second part (+15), which tells where the decimal 
point should be. The part before the E is the mantissa, and the part after the- 


E is the exponent. 
“scientific notation works equally well for very small numbers. For example, 


| .000000000423 


1 would become, in scientific notation, 
4.283E—10 


The minus sign after the E shows that you moved the decimal point from left 
to right. 

Table 4-4 compares scientific and ordinary notation. 

Scientific notation can be used wherever you can use an ordinary constant 
ina BASIC program, except in line numbers. It works for any constant of any 
size — even an ordinary one like 2E 0, although 2 is obviously a simpler and 
easier notation. 

The computer's PRINT command displays numbers in scientific notation if 
they are larger than 1E +13 or smaller than 1Е-6. The way the computer 
stores the numbers internally, however, does not change; it just displays them 
differently. 

Try entering some numbers into PRINT statements using scientific notation, 
like this: 


PRINT 1.492Е +3 


If you choose numbers that are not too large or too small, the computer will 
print them in ordinary notation. Doing this, you can compare the two nota- 
tions to make sure you understand how to convert numbers from one to the 
other. 


Table 4-4. Examples of Scientific and Ordinary Notation 


Ordinary Scientific 


005 5E-3 
0057 5.7E—3 
01 1E-2 
8 8E-1 
3 3E0 
56 5.6E1 
608 6.08E2 
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Size of Numbers and Rounding 


The TS1000 and ZX81 store and use numbers in-errinternal format called 
floating point. The term floating point means that the decimal point can be 
located anywhere it needs to be in order to express numbers of different sizes. 
You do not need to know many details about how floating point format works, 
just that BASIC automatically translates your numbers into floating point 
format when you enter them. 

The computer can handle very large and very small numbers precisely, but 
it does have some limits. The TS1000 and ZX81 can store numbers between 
ТЕ +38 and 4E-—39. If you try to use a number that is too large, the computer 
will display error code 6 (the "arithmetic overflow error") at the lower 
left-hand corner of the screen. If you try to use a number that is too small, the 
computer will simply convert the number to zero and continue the calcula- 
tion without reporting an error. 

To demonstrate these limits, enter the following commands: 


PRINT 2x1E-438 


PRINT ЈЕ-28 


The first command gives the report code 6/0 and does not print an answer. 
The second command prints the answer 0 and gives the report code 0/0, 
which means no error. 

Numbers in the TS1000 and ZX81 have a maximum of nine digits. The 
PRINT command rounds off after eight digits. To see how this works, enter the 
following command: 


PRINT 123456788 


Observe that the computer rounds off to 123456790. Similarly, it rounds off 
the fractional number 0.123456789 to 0.12345679. The only time this round- 
ing error is likely to cause problems is when you subtract two numbers that 
are very close together. For example, the following command should give an 
answer of 5, but it gives 0 instead: 


PRIMT 1£i24+5-1El2 


The number 1E12 is so big compared to 5 that the 5 disappears in the 
rounding error. This isarather unusual calculation because it uses a mixture 
of very large and small numbers. For the kind of programs you will ordinar- 
ily write, you will probably never need to worry about rounding error. 
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STRINGS AND STRING EXPRESSIONS 


The TS1000 and ZX81 can store and manipulate two kinds of data: numbers 
and strings. À string is any data that should be treated as text. You already 
know how to use text in a print command, like this: 


PRINT "GOOD MORNING" 


The text “GOOD MORNING” is a string. To specify a string, just put its 
characters between quotation marks. Some examples of strings are 


"FOURSCORE AND SEVEN YEARS AGO" 
"da LF" ШЕК 


“ADDRESS OF CUSTOMER” 
"1223-45-5789" 

“CINCO DE MAYO" 
HESH" 


“TIMEX-SINCLAIR leaa” 


The last example is the empty string, which contains no characters at all. 
Another name for it is the null string. It is the only string whose length is 
zero. 

A string can be as long or as short as you like. It can contain graphics 
characters, reverse video characters, and any of the other characters on the 
keyboard, except the quote character (") itself. If strings could contain the 
quote character, the computer would not be able to tell which of the quote 
characters were part of thestring and which werethe markers at the ends of 
the string. Instead, the keyboard contains a special symbol called the quote 
image (SHIFT-Q) that takes the place of the quote character inside strings. The 
quote image looks like two quote characters in a row, but it acts like a single 
character. When you use the quote image in a string, it produces a single 
quote symbol in the display. For example, the command 


PRINT "I SAID ""BE CAREFUL’ TUI 
СЕ" 


will print the line 
I 2niP "BE CAREFUL” TUICE 


АЕ e س‎ 
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Do not confuse the quote image with the expression for the null string. 
They look exactly alikeon thescreen, but they are different. The null string is 
a pair of single quote symbols (SHIFT-P's), and it means a string with no 
characters in it. The quote image is a single symbol (SHIFT-Q), and it stands 
for a quote symbol inside a string. 


String Constants, String Variables 


Notice that the PRINT commands for strings are very similar to PRINT 
commands for numbers, like this one: 


ЕБІМТ Б 


This illustrates the fact that the computer handles numbers and strings іп 
very much the same way. It provides for string constants and string vari- 
ables, just as it provides for numeric constants and numeric variables. You 
can also combine strings in string expressions, just as you can combine 
numbers in numeric expressions. 

All of the strings just listed are string constants. Like numeric constants, 
they always have the same value. You have to type them in again, character 
by character, every time you want to use them. The TS1000 and ZX81 also 
allow you to use string variables. A string variable works the same way as a 
numeric variable, except that it represents a string instead of a number. The 
following example shows how to define and use a string variable: 


LET i$z"MODEL NUMBER" 
PRIMT Us 


Unlike a numeric variable, the name of a string variable must be exactly 
two characters long. The first character of the name must be a single letter, 
and thesecond character must be a dollar sign. The dollar sign distinguishes 
string variables from numeric variables. The differences between the names 
of string variables and numeric variables are shown in Table 4-5. 


Table 4-5. Differences Between Names 6» Me 
of String and Numeric Variables ae 
String Variable Names ^ New Numeric Variable Names + 
Begin with a letter Begin with a letter 
End with a dollar sign End with any letter or number 
Exactly two characters long As long as you like 
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Useastring variable whenever you need thesamestring more than once to 
avoid having to type it in again each time. A variable saves space in the 
computer because the computer only has to storethe variable once, no matter 
how many times you use it. À string variable also helps you avoid misspelling 
thestring when you use it over and over. That might not be a problem for a 
string like “GOOD MORNING”, but it could be very important if you had to 
enter a text that repeated one of the following strings several times: 

CHAUGOGGAGOGHANCHRAUGGAGOGCHABBUN 
AGUNGAMUAG 


FEVERUERS ICHERUNGSGESELLSCHAFT 
HUMMINGBIRD -ON-THE-LEFT 


With a variable, you only have to enter such a string correctly once. After 
that, it will be correct every time you use the variable. 


String Expressions 


| 


| 


A string expression combines strings in much the same way that a numeric 
expression combines numbers. When the computer evaluates a numeric 
expression, the result is a number. When it evaluates a string expression, the 
result is a string. The operations in a numeric expression are just the familiar 
arithmetic operations, such as addition, subtraction, multiplication, division, 
and exponentiation. The operations in a string expression are probably not 
familiar to you unless you already know BASIC. Even then, some of the 
string operations on the TS1000 and ZX81 are different from the ones on 
other computers. However, they are all easy to understand and use, and they 
do exactly the kinds of things you will need to do with strings: connect two 
strings together into one, extract parts of strings to make new strings, and 
change parts of strings. 


STRING CONCATENATION 


To concatenate strings means to join them together. The symbol for string 
concatenation is the plus sign (^). Although it is also the symbol for numeric 
addition, it means something entirely different with strings. For example, 
enter the following line: 


PRINT "БРЕЈ "+" "+"25" 
~~~ 
The computer takes the three strings in the command, “APRIL”, * ", and 
“25”, and joins them into a single string that prints as 


APRIL 25 
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The space could also be part of one of the other strings, like this: 
PRINT “APRIL "+25" 


String concatenation works the same way in assigning values to variables 
as it does in PRINT statements, as you can see from the following: 


LET Bk="APRIL "+25" 
PRINT Bs 


Each of these alternatives prints the same line on the screen, namely: 


Use the + operator any time you want to join two or more strings together 
into one. Do not try to use it, though, with a mixture of numbers and strings. 
For example, if you enter the command 


PRINT "“RFRIL' +25 


the computer will refuse the line and display the © cursor, indicating а 
syntax error. Remember that the + symbol can represent two totally differ- 
ent operations. One refers to numbers and tells the computer to add them. | 
The other refers to strings and tells the computer to concatenate them. A + | 
symbol with a string on one side and a number on the other side just doesn't 
make sense. 

String concatenation can be useful in many ways. For example, suppose 
you were trying to decide on a name for your newborn daughter. You might 
have a list of 20 or 30 possible first names and just as many middle names, 
and you might want to look at all the different combinations of these with 
each other and with your last name. To do this, you would need a program to 
concatenate the names in all possible combinations and list them. Such a 
program would require some features of BASIC that you have not learned 
yet, but it gives you an idea of how string concatenation could be useful. 

The other arithmetic operators (-, *, /, and **) have no meaning for strings. 
You will get a syntax error report (the & cursor) if you try to use them. 


SUBSTRINGS 


Another useful operation on strings is one that extracts part of a string to 
make a new string. The name for such a part of astring is a substring, and the 
operation that extracts it is called slicing. To choose the part of the string you 
want, you must specify its first aniPlast characters by their locations in the 


string. For example, suppose you have a string that gives the part number of 
some item in your business inventory, and you want to use just the third 
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through the fifth characters (or digits) in the part number. Enter the part 
number into the computer like this: 


LET P="AS92G476529" 


Then, to extract the third through fifth characters in this string, use the 
following command: 


LET G5$-P$í3 TO 5) 


(The symbol TO is SHIFT-4, not the separate letters T and O.) This command 
tells the computer to take a substring of string P$, from the third to the fifth 
character, and makethat into a new string with thename G$. Now when you 
enter the command 


PRINT 6% 


the computer prints 923. Of course, you could easily look at asingle inventory 
number like this and extract the section you want by yourself. However, if you 
had hundreds or thousands of such numbers in your inventory, a computer 
program to do it for you would save a great deal of work. 

A slicing command can extract any part of a string in this way, as long as 
the numbers on either side of the TO symbol correspond to actual locations in 
the string. If the second number in the command is larger than the number of 
characters in thestring, the computer will report error code 3, “subscript out 
of range." The computer will use the null string if the number on the left is 
larger than the one on the right, as in the following command: 


PRINT Р%фі5 TO 3! 


‚ The numbers on either side of To in the slicing command are optional. If 
| you omit the first number, the computer assumes that it is 1. If you omit the 
"| last number, the computer assumes that it is the number of the last character 
| in the string. So for the string P$=“A 3923476329” in the example just used, 
' the command 


PRINT PSITO 656) 
gives exactly the same result as the command 
PRINT Pll TO 5) 
Because the example string contains 11 characters, the command 
PRINT Paid ТО! 
gives the same result as 
PRINT Рфі4 TO 11! 
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To extract just one character from the string (the fifth character, for 
example), you can replace the full notation 


PRINT FSIS TO 51! 
with the abbreviated notation: 
PRINT РЕГЕ) 
Finally, the command 
PRINT Pi TO 1 


specifies the entire string P$, because the numbers that go with TO will 
default to the first and last characters in the string —that is, the first and last 
characters will be used in the absence of other instructions. 

Most of these examples use the PRINT command to make it easier to see how 
the slicing works. String slicing works the same way in a LET statement, 
however, as you can see from the following: 


LET z$-zP$ià TO Si 


In fact, a sliced string can be used anywhere in a BASIC program wherever 
any other kind of string can be used. 

The following example illustrates string slieing. Suppose you had a long 
list of geographical place names, each one stored in a string. You want the 
computer to print out just the ones that begin with the word NEW. A short 
program to do this is the following: 


10 РЕМ DEFINE SOME STRINGS 
=й LET Ag="SOUTH AMERICA” 
30 LET Es="NEL YORK" 

48 LET C$z"MHEUFOLUNDLBRHD" 
га НЕМ NOH TEST THEM 


ба IF Agil TO 3! ="НЕН” THEN Р 
АТНТ A$ 

70 IF 2%:1 TO 3! = "NEU" THEN F 
RINT BS 

358 IF C$:1 TO 3! ="NEW" THEN F 
RINT C$ 


In Chapter 5 you will learn how to use loops to make such programs neater 
and easier to write, even for very long lists of names. For now, just observe 
how the string slicing works. Run this program, and the computer will print 
these two lines on the screen: 


ЧЕЧ YORK 
HELFOUNCLAND 


To select only those strings that begin with NEW as aseparate word, simply 
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specify the slice (1 TO 4) and the substring “NEW ” with a space at the end. 
Then lines 60, 70, and 80 of the program become 


ба IF Я$:1 TO di ="NEW " THEM P 
RINT AS 

YO IF Beil TO 4)z"NELU " THEM P 
RINT Es 

88 IF C$il TO 43z"MEU " THEN P 
RINT СФ 


After you run the program the sereen looks like this: 
HEL YORK 


STRING INSERTION 


Now you know how to extract any part of a string to make a new, shorter 
| string. The computer also has a similar command, the substitution com- 
| mand, that does just the opposite: It takes a shorter string and replaces part 
| of a longer string with it. For example, define a string by executing the 
' following command: 


LET A$=" JUNE 5, 172 


bl 


Then execute the substitution command 

LET афеј TO 4)z"JULY" 
and ask the computer to print the result, using the command 

PRINT AS 

The computer now prints this revised line: 
JULY 5, 1723 

The command 
LET #%(1 TO 4) 2 у" 


told the computer to substitute the substring “JULY” for characters 1 through 
4 of the string A$. If the new substring is shorter than the original one, the 
computer fills in with blanks. Thus, the commands 


LET AS="JUNE Б, 172, 
LET H$il TO di="MAY" 
PRINT AS 


Gl 
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will print the result with two spaces between May and 5, as follows: 
MAY 5, 1723 


On the other hand, if the new substring is too large for the space that you 
specify, the computer will throw away the extra characters. The commands 


LET H$z'"JLUHE 5, 1723" 
LET 8601 TO 41="AUGUST" 
PRINT A$ 


will print the line with “August” abbreviated, as follows: 
AUGU =, 1723 


Clearly, you may get strange-looking results if you are not careful. Neverthe- 
less, substring substitution is a very powerful tool for manipulating text and 
graphics. 


COMBINING STRING OPERATIONS 


Recall that each operation in a numeric expression has its own priority, and 
that the computer always does the operation of highest priority first unless 
parentheses indicate a different order. The same is true for string expres- 
sions. Slicing has a higher priority than concatenation, so it always comes 
first. For example, the following commands Е 


PRINT “STRING "+ EXPRESSIONS" {1 
TO 3) 

will print the string 
STRING ESPRESSI 


because the slicing operation (1 to s) applies first to the string “EXPRES- 
SIONS”. The resulting string, “EXPRESSI”, combines with “STRING”. 

If you want the computer to perform these two operations in the opposite 
order, you must use parentheses to specify the order of operations. For 
example, to concatenate "STRING " and “EXPRESSIONS” and then slice 
out and display the first eight characters of the concatenated string, enter the 
following command: 


PRINT ("STRING “S$ EXPRESSIONS" I ї 
This command concatenates “STRING ” and EXPRESSIONS" first because 
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they are enclosed together in parentheses. Then it slices out characters 1 to 8 
of the concatenated string to give 


STRING E 


A | Otherwise unneeded parentheses thus have the same function in string 
li expressions as they do in numeric expressions. They tell the computer to 
i | perform the operations inside them first, 


FUNCTIONS 


You have seen how to combine numbers or strings into an expression that 
the computer evaluates to produce a new number or string. In addition to 
this, the computer can evaluate mathematical functions. These functions can 
appear in expressions, just as numbers or strings do. 


Numeric Functions 


An example will help to explain what a function is. The absolute value is a 
numeric function. The symbol for absolute value is ABS, at the bottom of the с 
key. Recall that the way to enter a function (or anything printed below a 
white key-square on the keyboard) is to press FUNCTION (SHIFT-ENTER) and 
then the key that has the function name under it. To enter the function ABS, 
press SHIFT-ENTER and then the с key. The @ cursor appears when you press 
SHIFT-ENTER, reminding you that the computer will interpret the next key- 
stroke as a function. 

Enter the following line: 


PRINT ABS -6 


Observe that the computer prints the answer 6. The ABS function takes the 
number to its right, discards the minus sign if the number is negative, and 
uses the resulting number. The number on the right is the argument of the 
function, and the result is called the value of the function. If the argument of 
the ABS function is a positive о. then the value is the same as the 
argument. Ifthe argument of the ans function is a negative number, then the 
value is a positive number of the same magnitude. Enter some more com- 
mands like the one above, but with different numbers т the place of —6, and 
observe how the ABS function works. 

The argument of a function like ABs can also be a numeric expression 
instead of a single number. (Recall that you can use a numeric expression 
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wherever you can use a number, except for line numbers.) For example, the 
command 


PRINT O ABS 11818-18: 


tells the computer to divide 12 by 2 (to get 6), then subtract 10 (to get —4), and 
finally to take the absolute value and print it. The absolute value of —4 is 4, 
and that is what the computer prints. 


Notice that the argument (12/2—10) has parentheses around it. Whenever | 


you use an expression as the argument of a function, you must enclose the 
expression in parentheses. Otherwise, the computer will use only the first 
number of the expression as the argument of the function. In other words, 
functions have a higher priority than the arithmetic operations +, -, /, and 
+=. If you enter the same command but without the parentheses, like this: 


FAINT ABS 12/72-10 


the computer will first take the absolute value of 12. It then divides the result, 
also 12, by 2 to get 6, and finally subtracts 10 to get the answer —4. To make 
this easier to visualize, we can draw brackets under the commands to show 
which operations occur first: 


PRINT ABS (22/2-1@! 


PRINT ABS 1272-18 


Extra parentheses never do any harm, as long as they are in pairs. If you 
are ever uncertain about whether you need parentheses, put them in. The 
computer will always do the operations inside the parentheses first, then 
combine the result with whatever is outside the parentheses. 

Absolute value is thus one example of a function. It has one argument, 
which can be a numeric constant, variable, or expression. The ABS function 
itself can also appear as part of an expression, just as if it were a variable. The 
argument of a function can even be an expression that has a function in it, 
like the following: 


PRINT 7-HB5 1122-AES 1-3451) 


Theonly restriction is that the ABs function takesonly numeric arguments. 
If you try to enter a command like 


PRINT ABS “GOOD MORNING” 
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КЕРЕН 
— 


the computer will report a syntax error by displaying the E cursor. The 
value of the ABS function is also a number, and so you cannot use it in places 
where the computer expects a string. 

The TS1000 and ZX81 keyboard contains a number of different functions. 
Each function appears beneath one of the white key-squares. (A few of the 
symbols beneath the key-squares, such as TAB and AT, are not functions.) Do 
not be concerned if some of these functions are unfamiliar. For example, if 
you have never studied trigonometry, the trigonometric functions will seem 
obscure. In that case, you probably will not need them in your programs 
anyway. The important thing is to understand how functions work and how to 
use the ones you need. 

Table 4-6 describes all the functions on the keyboard that involve only 
numbers, not strings. Functions that involve strings are explained later in 
this chapter. 


Table 4-6. Functions Not Involving Strings 
Function Value 


ABS The absolute value of the argument. Equal to the argument if it is posi- 
tive or zero. Equal in magnitude but with positive sign if the argu- 
ment is negative. 


ACS The trigonometric arc cosine of the argument. 

ASN The trigonometric arc sine of the argument. 

ATN The trigonometric arc tangent of the argument. 

COS The trigonometric cosine of the argument. 

EXP The exponential of the argument. Equals the number e (2.7182818; the 
base of the system of natural logarithms) raised to the power of the argu- 
ment. 

INT The integer part of the argument. Equals the largest integer that is 
smaller than or equal to the argument. 

LN The natural logarithm (base e) of the argument. To convert a natural 


logarithm to a common logarithm (base 10), divide the natural loga- 
rithm by LN 10. 


PEEK The contents of the memory location specified by the argument (see 
Chapter 7). 
PI 3.1415927, the ratio of the circumference of a circle to its diameter. 
RND A random number between zero and one. 
SGN The signum of the argument. Equals one if the argument is positive; 
zero if the argument is zero; and minus one if the argument is negative. 
SIN The trigonometric sine of the argument. 
SQR The square root of the argument. 
TAN The trigonometric tangent of the argument. 
USR This function calls the machine language subroutine that begins at the 


memory location specified by the argument. The value is taken from 
the BC register pair (see Chapter 8). 
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All the numeric functions have one thing in common: Each one converts its 
argument into a new number (its value) that is in some way related to the 
number that was the argument. The particular relationship between argu- 
ments and values is different for each function. 


INT AND ROUNDING 


INT gives the first whole number (integer) that is smaller than or equal to 
the argument, as shown in the examples in Table 4-7. 

A function that rounds off to the nearest integer would be more useful for 
ordinary arithmetic. Although the TS1000 and ZX81 do not have such a 
function, you ean get the same result by first adding .5 to the argument and 
then using INT. The following program rounds off the value of X and prints 
the result: 


іс LET *:=4,9 
20 FRINT INT (2+,23 


Run this program several times, editing line 10 each time to change the value 
of X. Some typical results are shown in Table 4-8, 

Because of the way the computer calculates numbers, INTsometimes gives 
incorrect results for arguments that should be exact integers. The following 
program illustrates the problem: 


іс LET Я=5+.4 
20 FRINT A 
за ЕБІМТ INT Я 


Instead of printing 2 twice, as it should, the computer prints 2 the first time 
and 1 the second time. This happens because the computer’s internal repre- 
sentation of 5*.4 is not exactly 2. 

Check your programs for these errors. If they show up, you can correct 
them by testing the results of the program and correcting the math as 
necessary. 


Table 4-7. Examples of INT Rounding 


Argument Value of INT 


3 3 
—3 —3 
8.2 8 
—8.2 =9 
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Table 4-8. INT Rounding with X + .5 


Before Rounding After Rounding 
4.9 5 
8.2 -8 
10 10 
549.23 549 
—8.2 -8 
-8.8 -9 


NUMERIC FUNCTIONS WITH NO ARGUMENT 


Most of the functions in Table 4-6 have a single argument. Two of them, 
however, have no argument. These are Pr and RND. The first of these, PI, is an 
example of a constant function. That is, the function's value is always the 
same, namely 3.1415927. This number, which expresses the relationship of 
the diameter of a circle to its circumference, occurs frequently in many kinds 
of mathematical formulas. The TS1000 and ZX81 provide it just to save you 
the trouble of typing in this number when you need it. 

The function RND also has no argument, but it is not a constant function. In 
fact, it is useful precisely because you cannot predict what its value will be. 
The RND function is a random number generator; its value is a randomly 
chosen number between zero and one. 

To see how it works, first execute the command 


RANE 


Do not confuse this RAND with RND. RAND is a command, located on the T 
key, while RND is a function, located below the same key. Whenever you 
execute RAND, the computer tesets the random number generator so that it 
will not produce the same sequence of random numbers it did the previous 
time you ran the program. (If you want the same sequence each time, put a 
number after RAND. As long as this number remains the same, the computer 


will produce exactly the same sequence of numbers every time.) 
Now execute the command 


PRINT RNE 


several times in arow and notice what kind of numbers you get. They will all 
be between zero and one. If you execute the command enough times, they will 
cover the whole range between zero and one fairly evenly. 

Random numbers are important in many computer programs. Computers 
are designed to be very predictable. That is, if you give a computer the same 
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commands today that you gave it yesterday, it is supposed to do exactly the 
same thing it did then. However, some computer programs need to be unpre- 
dictable in some way. Many computer games contain a built-in element of 
chance. For example, the computer might simulate a roll of the dice or 
provide a one-in-ten chance that one spaceship will blow up another space- 
ship when it fires its weapons. Even in a game like chess, the computer's 
moves should be a little bit unpredictable so that a player can try the same 
opening several times and get a different game each time. 
You ean usethe RND function to simulate the roll of a die—that is, to display 
a random integer between one and six — by means of the following program: 
се REM GET 
AHD 1 
да LET Я 
ом КЕМ C 
EM 1 ANC 7 
ва LET. Ais 
Е 


та REM Alley THE DECIMAL 
PART 


за LET A=INT A 
ай REM PRINT THE RESULT 
180 PRINT Я 


HUMBER BETUEEH Y 


ЕТ ТО HUMBER ЕЕТЧЕ 


Observe how ]ine 60 converts a number between zero and one into a number 
hetween one and seven. First it multiplies the original number by six to get a 
number between zero and six. Then it adds one to produce a number between 
one and seven. However, this number is not an integer; it has digits to the 
right of the decimal point. Line 80 uses the INT function to throw away the 
fractional part and leave just the whole number that was to the left of the 
decimal point. The result is an integer between one and six. 

Run the program 20 or 30 times, keeping track of how many times you see 
each digit. If you run the program enough times, it will print each of the six 
digits about the same number of times. Any program that played a game 
involving dice would probably contain a routine like this one. 

If you don't understand completely how the program works, insert the 
following lines and run it again: 


me 
(ПІЛ 
nt 
monu 


Now the program shows what happens at each stage of the calculation. It 
prints the initial random number, which is between zero and one. On the next 
line it prints the "shifted" random number, which is between one and seven. 
On the third line it prints the final result without the decimal part. 
Whenever you are uncertain about how a program works, try inserting Y 
PRINT statements like these to display what happens after each step. This is | 
also a good technique for finding and fixing errors in your own programs. 
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The die program uses three separate LET statements: 


40 LET A-RMD 
a ӘЗ LET A=8+A+1 
1 80 LET A=INT A 


A program that uses several short, fairly simple statements is easier for 
\ people to understand. The program will run faster and take up less of the 
|.  eomputer's memory, however, if these operations are condensed into one LET 
statement: 


SS 


~ № LET Н-ІМТ i&5sREND41! 


This single statement does exactly the same thing as the three statements. 


TRIGONOMETRIC FUNCTIONS 


If you have studied trigonometry and want to use the trigonometric func- 
tions, you will need the following information: The argument of the functions 
SIN, COS, and TAN must be in radians. The values of the inverse trigonometric 
functions ACS, ASN, and АТМ are also in radians. If you prefer degrees instead, 
use the formula: Degrees X (7/180) = Radians. The following example takes 
an angle B in degrees, converts it to radians, computes its sine, and stores the 
result as the variable A: 


LET Я=5ІЧ ((PI-150)+D1 


Similarly, the following command computes the arc tangent of Y in radians, 
converts the result to degrees, and stores it as X: 


LET x-ziíl8Q-PI)«mHTH Y 


Be aware that some functions produce “illegal” answers. This is generally 
caused by a function calculation that results in a division by zero or an 
answer that is too large or too small for the computer's range of numbers. 


Other Numeric Functions 


Some of the other numeric functions have special properties that you may 
need to know. The argument of the natural logarithm function, LN, must be 
positive or the computer will report error A. It reports the same error 
(“invalid argument") if you try to use the ser (square root) function with a 
negative argument. Like most of the limits mentioned about the trigonomet- 
ric functions, these restrictions are not imposed by the computer itself They 
are mathematical properties of the functions LN and SQR. 


80 The ZX81/TS1000 Home Computer Book 


Functions Involving Strings 


All of the above functions have numbers as their arguments and numbers 
as their values. Several other functions on the TS1000 or ZX81 keyboard have 
arguments that are strings instead of numbers, and some of them represent 
strings instead of numbers. 

The name of a function shows whether it represents a number or a string. 
Ifthe name ends with the symbol $, the function represents a string. If it ends 
with a letter, the function represents a number. The names of string func- 
tions look very similar to the names of string variables. Both end with $. A 
function name, however, contains more than one letter. 

Table 4-9 summarizes the TS1000 and ZX81 functions that involve strings. 


THE INKEY$ FUNCTION 


The simplest string function is INKEYs. This function does not have an 
argument. Its contents are determined by whether or not you are pressing a 
key on the keyboard at the time the computer executes INKEYs. If a key is 
pressed, then INKEY$ will contain a one-character string consisting of the 
character on the pressed key. If no key is pressed at the time, then INKEY8 will 
contain the empty string (^ "). The following program illustrates how INKEY£ 
works: 


ла 51010 

20 REM THE NEXT STATEMENT JUST 
WASTES TIME 

за LET CUMMY=(S0QR 2+ +508 Z] 
48 LET Z$=INKEY$ 


Table 4-9. Functions Involving Strings 


Function Value 
CHR$ A string consisting of the character in the character code that the numeric 
argument represents. 
CODE The number in the character code that represents the first character in 
the string. 


INKEY$ A string consisting of the character for the key that is pressed on the 
keyboard. If no key is pressed, the value is the null string (^ "). 


LEN The number of characters in the string. 

STR$ Thestring you would seeon the screen if you asked the computer to PRINT 
the argument. 

VAL If the argument string is a numeric expression, the value of VAL is the 


number you get when you evaluate the expression. If the argumentstring 
is not a numeric expression, the computer reports an error. 
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50 PRINT Z$ 
60 IF Z$="" THEN FRINT “YOU DI 
D NOT PRESS H KEY" 


Remember to use SHIFT-P for the “ " symbols in line 60. Do not use SHIFT-Q. 

The first three statements produce a delay, which gives you time to enter 
RUN and remove your finger from the ENTER key before the computer gets to 
the INKEYs function in line 40. Run the program, remove your finger from 
ENTER, and quickly press another key (such as A). Hold it down until you see 
the letter A appear on the screen. When the computer executes line 40, it 
checks the keyboard and finds that the A key is pressed, so it assigns "A" to 
the Z$ variable in the program. It does not print the final message when it 
reaches line 60, because Z$ does not contain the empty string. Now run the 
program again, but do not touch the keyboard while the program is running. 
This time when the computer executes line 40, it assigns the empty string " " 
to Z$ because no key was pressed. Then when it gets to line 60, it prints the 
message 


YOU DID HOT PRESS A KEY. 


INKEYs reads the keyboard while a program is running, without stopping 
and waiting for input. It is especially useful for games and other kinds of 
interactive graphics. The program can check the keyboard and decide what 
to do next, depending on which key the user presses, all without interrupting 
the action on the screen. INKEY$ will correctly detect any of the letters, 
numbers, symbols, and even the editing functions such as EDIT, DELETE, and 

_ the arrow keys. However, it will interpret the SPACE key as BREAK instead of 
И SPACE, stopping the program with report code D. 


THE LEN FUNCTION 


The argument ofthe LEN function is a string, and its value is a number. The 
value is simply the number of characters in the string argument. In other 
words, LEN counts the number of characters in the string. To demonstrate it, 
enter the following commands: 

PRINT LEN "HBCDEFGH' 

PRINT LEW 

PRINT ШЕН "4" 

LET Ug="TESTSTRING" 

PRINT il&$iLEM 15-2 TO LEN Ui 


The correct answers are 8, 0, 1, and ING. The last example shows how to use 
the LEN function to sliceout characters at the end of astring. Observe how the 


"C ——e—!———— ———— —————————— ج‎ 
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LEN function appears in the slice specification. You can use it just as you 
would use a constant or a numeric variable. 


STR$ AND VAL 


The argument of the sTR3 function is a numeric expression. The sTR$ 
function converts this number into a string that looks exactly like what you 
would see if you told the computer to print the number on the screen. The 
following program shows how it works: 


18 РЕМ DEFINE A NUMERIC VARIAB 


LE 
Ей LET vz58R 3 
за REM МЕКЕ A STRING FROM IT 
du LET Н$=5ТН$ Y 
50 FEM РБІМТ ERCH OF THEM 
ва PRINT т 


780 PRINT A$ 


The computer prints exactly the same thing for A$ as it does for Y, although 
A$isastring and Y is a number. 

Use STR3 when you want your program to calculate a number and then 
determine some special property of the number, such as how many charac- 
ters it will take to print the number. To illustrate the method, first suppose 
you have in some way calculated a variable called Y. The following statement 
produces a value for Y: 


10 LET ¥=S0F 2 


If you wanted to print no more than five characters, for example, you could 
use the following program: 


Ес НЕМ CONUERT Y TO A STRING 

20 LET 7%-5ТЕ% Y 

de РЕН DETERMINE THE LENGTH OF 
z$ 

со LET LEWGTHSLEN Z$ 

BG REM PRINT IF ІТ ја HOT TOD 
LONG 

FO IF LENGTH + 5 THEN PRINT + 

за НЕМ OTHERWISE, PRINT FIRST 
= CHARACTERS 

за IF LENGTH = 
$11 TO 51 


THEM PRINT Z 


The зтвз function gives you a way of determining how many characters it 
would take to print the number. 
The function VAL does just the opposite of srRs. That is, VAL converts a 
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string such as Z$, which resembles the way the computer would print out a 
number, into a numeric variable. For example: 


18 LET B$2'"za42'" 
кё LET C=UAL BS 
за LET Басуш 

da PRINT Db 


The computer prints 1020 when you run this program. 

If you need to do arithmetic with a string that looks like a number (or a 
numeric expression), first use the vAL function to convert the string to a 
numeric variable. This function also provides a way of dealing with errors 
that the people who use your program might make in the process of typing in 
their data. Instead of reading data as numbers, you can read each piece of 
data аз astring and check it to make sure it has no errors. If it has errors, the 
program can print an error message and ask for the number again. If it has 
no errors, use VAL to turn the string into a number and proceed with the 
ealculation. 

Of course, the argument of VAL cannot be just any string. It must be astring 
(or a string expression that evaluates to a string) that looks exactly like a 
valid numeric expression. For example, the following command is "legal," as 
long as the variable X has been defined: 


PRINT URL "INT х + Е" 


CODE AND CHR$ 


In order to understand the final two string functions explained in this 
chapter, you need to know how the computer stores strings in its memory. 
Internally, the computer can only deal with numbers. Therefore, it uses 
numbers to represent characters. Each character has its own unique number. 
The list of characters and their numbers is the character code. Every com- 
puter that handles text uses a character code of some kind, but the details of 
the code may be different on different computers. For example, some com- 
puters use the number 1 to represent the letter A, while others use 65 or 38or 
some other number to represent A. The TS1000 and ZX81 use their own 
special character codes. You will find a complete list of the characters and 
their corresponding numbers in Appendix C. 

Inside the computer, a string is just a list of numbers. When you ask the 
computer to print a string, it takes the string's numbers one at a time, looks 
each one up in a table in read-only memory (ROM), and displays the corre- 
sponding characters on the screen. You usually do not need to think about the 
character code at all, because the computer takes care of the conversion for 
you. 


84 The ZX81/TS1000 Home Computer Book 


However, you may sometimes need to deal directly with the character 
codes. The computer provides two functions for this purpose. The CODE 
function takes a string argument and returns as its value the character code 
of the first character in the string. For example, the following command 
prints the number 41 on the screen: 


PRINT CODE "D" 


Look up the character D in Appendix C, which confirms that its character 
code is 41. The argument of CODE can be any string expression. The function 
CODE simply evaluates the expression and uses the character code of the first 
character as its value. 

The function cHRs does just the opposite of CODE. The argument of CHR$is а 
number (or a numeric expression), and its value is the character that the 
number represents іп the character code. Use CHR$ just as you would use а 
string with one character in it. For example, if you give the command 


PRINT CHRS 41 


the computer prints the letter D on the screen, just as if you had given the 
command 


PRINT "D" 


Incidentally, besides the letters, numbers, punctuation, and graphics sym- 
bols, the character code in Appendix C contains a number for each of the 
BASIC commands and functions. It also has quite a few numbers that do not 
correspond to any character. For example, the following command: 


РБІМТ CHAR 210 


prints the function named PEEK because 210 goes with PEEK in Аррепдіх C. If 
you use PRINT CHR$ with a number like 75, which does not correspond to any 
character, the computer will simply print & question mark. 
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nput is information you put into your computer's memory. Output is 

information the computer sends to other devices, such as the television 

screen or printer. The principal output commands on the TS1000 and 
ZX81 are PRINT and LPRINT, which display numbers and strings on the 
television and printer, respectively. Chapter 4 introduced oneofthe primary 
input capabilities, INKEYs, which examines the keyboard while a program is 
running. This chapter presents another way of giving your computer infor- 
mation, the INPUT command. The chapter then explains some further capa- 
bilities of the PRINT command and introduces several other commands for 
controlling the display. 


THE INPUT COMMAND 


The INPUT command, like the LET command, gives a value to a variable. 
Use LET to specify the value of a variable in command mode or while you are 
writing a program, like this: 


LET GUAR=<293.4 


Use INPUT instead if you want to stop the program until you enter a value. 
This value, which can be string or numeric, is called the input variable. For a 
numeric variable, use an INPUT statement like this: р 


230 INPUT GUAR 
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Given this command, the computer displays the № cursor and waits. When 
you enter the value of QVAR, followed by ENTER, it continues with the next 
line of the program. The input variable to the right of INPUT must be a single 
variable, not a constant or a compound expression. 

If the INPUT variable is a string variable instead, as in 


іс INPUT ES 
the computer displays the Ж cursor with quotation marks around it, like this: 
Im m m 


The quotation marks show that the computer expects a string. 

If an INPUT statement uses a numeric variable, you must enter a number, or 
else the computer will report error code 2 at the lower left-hand corner of the 
screen. If an INPUT statement uses a string variable, you may enter any 
combination of letters, numbers, graphics, and other symbols. However, if 
you delete the quotation marks around the № cursor, the computer will 
display the € cursor when you try to enter thestring. Re-enter the quotation 
marks atthe beginning and end ofthestring, and the computer will accept it. 

Unlike most BASIC commands, the INPUT command does not terminate 
when you press the BREAK key. Since the BREAK key is the same as the SPACE 
key, INPUT interprets it as a space in the input rather than a break. For 
numeric variables, INPUT simply ignores spaces. For string variables. it 
treats а space as part of the string. To terminate a program that is waiting for 
numeric input, simply enter a letter instead of a number. The computer 
reports error code 2 and stops. If the computer is waiting for string input, 
delete the quotation marks and enter STOP (SHIFT-A) to terminate the program. 

A good program should print a message before the INPUT command to 
explain what kind of data it expects, especially if it uses INPUT several 
different times for different variables. The following program illustrates 
this technique. It asks for the radiusof a circle and then calculates and prints 
the circle's area: 


та РЕМ GET UALUE OF RADIUS 

20 FRINT “ENTER RADIUS" 

за INPUT Б 

48 РЕМ CALCULATE AND FRINT ARE 
50 LET ЯАНЕЯ=РТ+НУЯЕ 

ей PRINT AREA 


The INPUT statement can be used only in programmed mode. An INPUT in 
command mode, without a statement number, produces error code 8. All 
other BASIC commands can be used in either programmed or command 
mode, although some of them, such as STOP, FOR, NEXT, and RETURN, are useless 
in command mode. 
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FORMATTING PRINTED OUTPUT 


All the examples of the PRINT and LPRINT commands so far have printed 
only one string or number per line. Now you will learn how to print several 
such items on a single screen line and how to specify the arrangement of 
items on the screen. 


Using Commas 


One way of printing several items with one command is to separate them 
with commas, like this: 


PRINT 1,2.2.4.5 


Execute this command and observe how the computer arranges the numbers 
on the screen. The numbers appear in the same order as in the PRINT state- 
ment, but arranged in columns, two numbers per line, like this: 


1 2 
3 4 
5 
0/0 


If your system includes the Timex or Sinclair printer, you can also try an 
LPRINT statement with commas: 


LPRINT 1,2,3,4,.- 


With either PRINT or LPRINT, the computer displays two items per line. The 
first item in each pair starts at the beginning of the line and thesecond starts 
16 columns to the right. Since each line contains 32 character positions, the 
second item begins in the middle of the line. Thus, you can use this form of the 
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PRINT 0r LPRINT statement to print a table of numbers or strings lined up in 
columns. The leftmost character of each item lines up with the ones above it, 
in the first column or in the 17th column. 

If one of the items is longer than 15 characters, the computer skips to the 
next vacant starting position (that is, the first or 17th column). Therefore, a 
PRINT statement using commas may print one or two items per line, depend- 
ing on the items' lengths. Try the following example: 


PRINT "BBCDÉFGHIJELHMOPORSTUUUXY 
27. "RBC'."RBCDE^ 


After you press ENTER, the screen looks like this: 


ABCDEFGHIJKLMNOPQRSTUVWXYZ 
ABC ABCDE 


This format can cause problems if you don't know in advance how long each 
printed item will be. In such cases, you can better control the display by using 
other forms of the PRINT and LPRINT statements, described in the sections that 
follow. 


Using Semicolons 


A semicolon in a PRINT or LPRINT statement causes the computer to print 
the next item immediately after the previous one, with no extra spaces at all 
between them. The command 


PRINT "JOHH';"HBRY'";"LUCINDBR" 
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produces the line 
JUHhHHPBETLUCINDPaR 


You may also include spaces between the items as part of the names or as 
separate strings. The following example illustrates both methods: 


PRINT “JOHN "НЕКИ "O ULUCING 
B" 


It prints this line: 
JOHN HARY LUCINDA 


If the combined items to be printed are longer than a single line on the 
screen, the computer just goes on to the beginning of the next line when it 
reaches the end of the current one. 

The semicolon in a PRINT statement is similar in some ways to the string 
concatenation operator (+). For example, this command produces the same 
display line as the previous one: 


1 


ИИ URULUCIND 


T 


PRINT “шаны “жены 
а” 


However, the semicolon can be used only in a PRINT or LPRINT statement. It 
cannot be used in a LET statement, for example, where the + symbol is “legal.” 
Its one major advantage over the + operator is that the semicolon works for 
numbers as well as for strings. You can even mix numbers and strings in à 
single PRINT statement, with semicolons between them, as follows: 

PRINT “GLADIATORS ";5;", LIONS 

e 
Enter this command carefully, with all the spaces and punctuation marks in 
the right places, and the computer will print the following: 


GLRHDIPTORS в, LIONS а 
Thesemicolon does exactly the same thing regardless of whether the items 


it separates are in a single PRINT statement or separate ones. The computer 
will print the same line as before when you enter and run the following 


program: 
ја PRINT “GLADIATORS 
za PRIWT Б; 
за PRINT ", LIONS 


42 PRINT а 


The computer “remembers” whether the previous PRINT statement ended 
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with a semicolon. If it did, the computer begins the next PRINT statement 
where the last one ended. The location on the screen where the next PRINT 
statement will begin iscalled the print position. À PRINT statement ordinari- 
ly moves the print position to the beginning of the next line, but if the 
previous PRINT statement ended with a semicolon, the print position remains 
where it was. 

Use the semicolon to display a piece of explanatory text beside the result of 
a calculation. With this feature, the program to calculate the area of a circle 
can be made clearer as follows: 


10 РЕМ GET VALUE OF RADIUS 

20 PRINT "ENTER RADIUS" 

за INPUT R 

4@ REM CALCULATE ANE PRINT ARE 
54 LET HRERH-PIEsHEx*2 

ва PRINT “THE AREA ІЗ "¡AREA 


Using TAB 


The PRINT items TAB and AT provide still more ways of controlling the print 
position. The TAB is below the P key, and Ат is below the c key. Although they 
are not functions, you enter them exactly as you would enter a function, by 
first pressing the FUNCTION key to activate the a cursor. 

In a PRINT statement, TAB and AT look like variables or constants for 
printing. However, they do not actually print anything themselves. Instead, 
they change the print position for the next item in the PRINT statement, as in 
the following example: 


із FRIHT SUR 7 
SHURRE ROOT OF 7 

ва PRINT SR 4; THE 10; "15 THE 
BQUARE ROOT OF 4" 


ТАЕ 18; "15 THE 


After you enter the commands just given, the screen should display this: 


„2437513 ІЗ THE SQUARE ROOT OF 


~ ћа 


пл 
H 
trn 
4 


HE SQUARE ROOT OF 


Like the tab key on a typewriter, TAB moves the print position forward to 
the specified column. In the above example, TAB 10 moves the print position to 
column 10. If the print position is already past that column, TAB does not go 
backward. Instead, it moves to that column on the next line. Thus, TAB is 
similar to the comma separator but more powerful. While the comma always 
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Using AT 


moves the print position to the first or the middle column, TAB moves the 
print position to any column you specify. 

Using TAB in an LPRINT command controls the printer in the same way. If 
your system has a Timex or Sinclair printer, run the previous program with 
LPRINT substituted for PRINT in both lines. 

Each line on the display or the printer contains 32 columns, numbered 
from 0to 31 rather than from 1to 32. Therefore, TAB 0 puts the print position 
at the leftmost column on the screen, and TAB 31 puts it at the rightmost 
column. Given a TAB column larger than 31, the computer simply ignores the 
extra columns. For example, TAB 32 does the same thing as TAB 0, and TAB 33 
does the same thing as TAB 1. 

Use TAB to make different items line up neatly in columns. You can use it as 
many times as you like in a single PRINT statement, but make sure that none of 
the printed items is longer than the space between TAB positions. Remember 
to use a semicolon after the TAB column number. Otherwise, the print position 
will change again before the computer prints the next item. 


The print item AT provides the most complete control possible over the 
print position. It specifies both the line and the column where the next item 
will appear. While TAB only moves the print position forward from its present 
location until it reaches the specified column, AT moves forward, backward, 
up, or down if necessary to reach the specified location, regardless of where 
the print position was previously. 

An example is the following: 


PRINT AT 18,5; "BLINK" 


The first number after AT specifies the line, and the second number specifies 
the column. Thescreen contains 22 lines. The top line is line 0 and the bottom 
lineis line 21. (Actually, there aretwo more lines below line 21, but you cannot 
print on them. The computer uses them for its EDIT line and error messages.) 
The line number for Ar must be between 0 and 21, and the column number 
must be between 0 and 31, just like the column number for TAB. Unlike TAB, 
however, AT will not disregard the extra lines or columns if the numbers 
exceed this range. Instead, it will report an error. 

To understand how AT works, imagine that the display screen is divided 
into separate squares, one for each possible character position, as shown in 
Figure 5-1. The numbers down the left side of the drawing correspond to the 
22 screen lines, and the numbers across the top correspond to the 32 columns. 
To design a complicated screen display, refer to this figure or make a similar 
drawing of your own and fill in thesquares with the characters you want in 


—————————————————————— سسس 
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Columns 


2 ТЕШЕН 


Figure 5-1. Character positions on the television display 


the positions where you want them. Then read the line and column numbers 
from the drawing and use them in PRINT AT statements. 

With LPRINT, AT is not very useful because the printer paper is a continuous 
roll with no top or bottom line. Thus the line number in an LPRINT AT 
command has no meaning, and the computer simply ignores it and moves to 
the specified column in the current printer line. An LPRINT AT command 
must still have a line number smaller than 22, however, to avoid a syntax 
error. 

For graphics and animation, AT is very useful because it ignores anything 
that may already be on the screen at the new print position. It simply replaces 
the old text with new, as the following program demonstrates: 


la SLON 
=й PRINT AT 0,5; ‘BLINK 
за PRINT AT 8,5; "ВЕ ТНК” 
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Adapted from Timer User Manual by Steven Vickers, 9 1982 Timex Corporation 


40 PRIMT AT 2,5; “BRINE” 
S0 PEINT AT 9,5: “BLAINE” 
ве PRINT AT 0,5: "ВЕ IWEK” 
те PRINT AT 0,5: "BLING 
за PRINT AT 28,5: OBLINE" 


Remember to use the GRAPHICS key (SHIFT-9) before the reversed video char- 
acters and to press it again after each one to restore the № cursor. 

Watch closely as this program runs. The reversed video appears to move 
across the word rapidly from left to right. The computer actually prints the 
word BLINK seven times, with the reversed character in different positions, 
but it does this so fast that your eye sees а smooth movement across the word. 

To slow down the motion, insert a do-nothing statement after each PRINT 
statement to waste time. The sqR function is a good choice because it is 
relatively slow. The following will slow the program down: 


ја 210: 

га PRINT AT 28,2; BLINKE” 
285 LET Н=ЗыЕ 2 

за PRINT HT 0,5: У IHR" 
35 LET A=30R Е 

42 PRINT AT 8,5; OBINE" 
45 LET A==4R 2 

га PRIHT AT 8,5; "BLE" 
сс LET БсзШшЕ = 

ва PRINT AT 2,5; “BLIE” 
25 LET A=SGR 2 

7B PRIHT AT 2,2; "BLIN" 


J 
ЕЛ 


LET A=50R = 
PRINT AT а, 


п 
E 
ЕЛ 


"БІНЕ" 


To avoid typing in each new line, first just insert line 25. Then use the EDIT 
key to bring line 25 down to the bottom of the screen, delete the line number, 
typethe new line number 35, and press ENTER. The result is exactly thesame 
as if you had typed in line 35. Now EDIT line 35 to make line 45, andsoon. The 
revised program runs so slowly that you can see each individual letter being 
reversed and then restored to normal video. 

Try replacing зав with different functions, such as RND, SIN, ОГ VAL (with 
the appropriate kind of argument for each one), and observe the resulting 
difference in the rate of movement. 


Delaying with PAUSE 


The PAUSE command delays a program in a more controlled way than a 
function like ser does. For example, the following command instructs the 
computer to wait exactly one second before going on to the next line: 


PAUSE Ба 


2222 -Д:5Ф>>>ҡэəә>>>>>еэ>>мҡ>,>ь>”,”>,-ьь->->-5-5:5::--:5: 
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To get a timed pause, just multiply the number of seconds you want to pause 
by 60 and put the resulting number after PAUSE. (For the British model of the 
ZX81, multiply by 50 instead.) Change each of the delay statements in the 
previous "blink" program to PAUSE 30, run the program, and observe the 
result. Unfortunately, PAUSE produces a flicker on the screen. However, it is 
the only means of animation in fast mode, since the display disappears from 
the screen while any other statement executes. Enter and run the following 
example: 


ла FAST 

га FRIHT "СЕНО"; 

38 PFHUSE 120 

48 PRINT "MSTRRHTION' 


The computer displays DEMO for two seconds and then completes the word. 
An advantage of PAUSE is that the pause ends and the computer goes on 
immediately to the next line whenever you press any key on the keyboard. 
Furthermore, if the number after PAUSE is larger than 32767, the pause does 
not terminate at all unless you press a key. Thus, like INKEYs, this feature 
makes interactive keyboard input easy. The following example, which runs 
correctly in either slow or fast mode, makes the computer act like a typewriter: 


та FRUSE 40000 
га PRINT ІМКЕУФ; 
зе GOTO 10 


The coro command in line 30 causes the computer to go back to line 10 and 
repeat the PAUSE and PRINT commands over and over, until you press BREAK. 
You will learn more about Goro in Chapter 6. 

Incidentally, some of the first ZX81’s (and the 8K ZX80's) had a mistake in 
the PAUSE command. If your computer is one of these, you must follow every 
PAUSE command with this command: 


FORE 15437,255 


Without this POKE command the computer may go completely blank later in 
the program, after PAUSE has been executed. To determine whether your 
ZX8L is one that requires this extra command, enter the following lines: 


РЕІМТ @,25442 
PRINT PEER 54 


The first command should give 0.0625 and the second should give 136. If 
your result is different for either of these, remember to include the POKE 
command after every PAUSE. 


eee 
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GRAPHING WITH PLOT AND UNPLOT 


The PRINT AT command is ideal for animated text, but plotting and picto- 
rial graphing often require higher-resolution graphics. For this purpose, the 
TS1000 and ZX81 divide each character space on the display into four 
portions (called picture elements or pixels) like this: 


In the above drawing, the large square represents one character on the 
display, and each of the four smaller squares represents one pixel. Each pixel 
can be made black or white to form pictures or graphs on the screen. 

The special graphics characters on the keys 1, 2, 3, 4, 5, 6, 7, 8, Q, W, E, R, T, Y, and 
SPACE provide all the different combinations of black and white pixels that a 
character can have. For example, the following program uses the symbol on 
the v key to draw a diagonal line across the screen: 


ја SLO 

га FOR Р=а TO = 

за PRINT AT P,P: "№" 
40 NEXT P 


The commands PLOT and UNPLOT let you specify each pixel individually, 
instead of specifying them four at a time as graphics characters. The PLOT 
command makes the specified pixel black, and UNPLOT makes it white. The 
following program uses these two commands to draw a diagonal line from 
the top left and then erase it: 


la SLOW 

20 FOR Ега TO 45 
за PLOT Р,Р 

да NEXT P 

га FOR Р=@ TO 43 
ва UNPLOT F.P 

та NEXT P 


The PRINT command and the PLOT and UNPLOT commands are equally 
capable of producing any combination of black and white pixels on the 
display. However, some patterns are easier to program with one kind of 
command than with the other. Programs that draw pictures usually use 
PRINT; programs that draw line graphs usually use PLOT and UNPLOT. (Chap- 
ter 7 explains how to plot graphs on the TS1000 or ZX81.) 


Эд 
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The major differences between PRINT AT and PLOT/UNPLOT are shown pic- 
torially in Figure 5-2. These differences are 


- Pixels are only half as wide as characters. The screen has 64 pixel 
coordinates (numbered 0-63) from left to right and 44 pixel coordinates 
(numbered 0-43) from bottom to top. For character input, the screen has 
32 columns and 22 lines. 


° Character positions begin with (0,0) at the upper left corner of the TV 
screen. Pixel eoordinates also begin with (0,0), but at the lower left 
corner. 


Columns 
Àn example: this is the pixel (57,32) 


g 
£ 
© 
E 
E 
3 
Е 
Ф 
5 
я 
o 
E 
© 
и 
А. 
5 
E 
2. 
4 
са 
ы 
© 
= 
= 
8 
3 
о, 
р 


Pixel y-coordinates — — а 


62 54565860 46485052 44 384042 36 2628303234 202224 1012141618 8 6 4 2 60 ا 
596163 57 454749515355 212325272931333537394143 91113151719 5 3 1 1 
Pixel x-coordinates ————-—————9‏ 


Figure 5-2. Differences between PRINT AT (character) 
and PLOT/UNPLOT (pixel) input 
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Adapted from Timer User Manual by Steven Vickers, © 1982 Timex Corporation 


- The PRINT AT command specifies the vertical position (the line number), 
followed by a comma and the horizontal position (the column number). 
The PLOT and UNPLOT commands specify the horizontal coordinate first, 
followed by a comma and the vertical coordinate. 


- The print position moves to the next display line when a PRINT AT 
command is finished, unless the command ends with a semicolon. After 
a PLOT or UNPLOT command, however, the print position moves to the first 
pixel location after the changed pixel. Semicolons cannot be used in PLOT 
and UNPLOT commands. 


SCREEN CONTROL: CLS, CONT, AND SCROLL 


Three more commands that you will generally use in connection with PRINT 
affect the display. The first of these is cLs, which stands for “clear screen.” 
This command (on the v key) erases everything on the screen and moves the 
print position to the top left corner. One reason for using cLs is that the 
computer stops with an error message (error code 5) whenever a program 
tries to print more than 21 lines on the TV display. By using CLs in a program 
that prints more than 21 lines, you can print all the output without errors. 

The сіз command also helps when memory is so full that the EDIT key will 
not work. First put the edit cursor on the line you want to edit. Then execute 
cLs, followed by EDIT. Now the computer can use the memory that the screen 
display previously occupied, and you will be able to edit the line. 

You have two alternatives besides cis if you need to print more than 21 
lines. One possibility is to let the computer stop with error code 5 when the 
program tries to write past the bottom of the screen. Then enter the CONT 
command (on the c key). This instructs the computer to take up where it left 
off and continue running the program. Depending on the kind of error that 
caused the computer to stop, it may or may not continue. After error 5 (screen 
full), cont will always succeed. The computer will automatically clear the 
screen and continue printing, beginning at the top of the screen. 

The third (and often the best) alternative is the SCROLL command (on theB 
key). This command causes the computer to move everything on the screen 
up one line, making room at the bottom for a new line. Run the following 
program and observe the result: 


= SLUM 

да PRINT AT 2,2; "SCROLL DEMONS 
TRATION” 

20 SCROLL 


+ 
m TEN TO 
21 
ы 
^ 
І 
E 
T 
ћ 
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та PRINT 5ЫН 4 

ай SCROLL 

за PRINT ЗӘБ 5 
At the first SCROLL command (line 20), the print position moves to the bottom 
of the display. Thereafter, everything on the screen moves up one line each 
time SCROLL is executed. At line 80, the title line disappears off the top of the 
screen. 

Obviously, you should use SCROLL only in slow mode or with PAUSE. Other- 
wise, you will never see the lines that scroll off the top, since in fast mode the 
computer does not show the display until the program pauses or is finished. 

Table 5-1 summarizes the TS1000 and ZX81 input and output features. 


Table 5-1. Input and Output Summary 


Symbol Description 
INPUT À command that reads the value of a variable from the keyboard. 
INKEY$ A function whose value is the character on the key that is pressed when 
INKEY$ is executed. If no key is pressed, the value is the empty string. 
PRINT A command that displays numbers or strings on the television screen. 
LPRINT A command that displays numbers or strings on the printer. 

5 Anitem ina PRINT оғ LPRINT statement that moves the print position 
to the left side or middle of the screen, whichever comes next. 

н An item in a PRINT or LPRINT statement that causes the print position 
tostay atthe end of thelast character printed instead of going tothe next 
line. 

TAB Anitem ina PRINT or LPRINT statement that moves the print position 
forward to a specified column. 
AT Anitem ina PRINT or LPRINT statement that moves the print position 
forward or backward to a specified column and to a specified line for a 
PRINT statement (the line number is ignored in an LPRINT statement). 
PLOT A command that darkens a pixel (one-fourth of a character square) at a 
specified location. 
UNPLOT A command that whitens a pixel at a specified location. 

PAUSE A command that waits a specified period of time before going on to the 
next line of the program. The display is visible during the pause, even in 
fast mode. 

CLS À command that clears the screen. 
CONT À command that tells the computer to continue after an error and is 
used to see more output after the screen fills up. 
SCROLL A command that moves the entire display up one line to make room for a 
new line at the bottom. The top line disappears. 
LIST A command that displays the current program on the television screen. 

LLIST À command that displays the current program on the printer. 

COPY À command that copies the television screen display to the printer. 
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DRAWING PICTURES 


Table 5-1 includes all the different printing capabilities of the TS1000 and 
7X81. These capabilities give you all the tools you need to draw pictures on 
the screen or printer. Look again at the graphics characters on the top three 
lines of the keyboard. Recall that you enter a graphics character by first 
pressing GRAPHICS (SHIFT-9) to turn on the ¡E cursor, which stays on until you 
press GRAPHICS again. While the E cursor ison, enter any graphics character 
by shifting the key where the graphics character appears. Enter the reverse 
video image of any letter by pressing it without SHIFT while the E cursor is 
on. A shifted key with no graphics character on it produces the reverse video 
image of its shifted symbol. 

The keyboard contains 21 graphics symbols. You can draw a great variety 
of pictures by using them in PRINT or LPRINT commands, in the same way as 
for ordinary text. Each graphics symbol uses a space the same size as any 
other character, and TAB and AT work the same way for graphies characters 
as for any other printed text. As already explained, the graphics symbols on 
the keys 1through s and о, W, Е, в, T, and v divide the character space into four 
square quarters (pixels). You can make any one of the four quarters black 
and the rest white, or any one of them white and the rest black, or two of them 
black and the other two white, just by selecting the appropriate graphics 
symbol. The remaining graphics symbols, on А, s, D. F.G, and н, provide а grey 
color for parts of the character space, and the sPACE key produces a solid 
black character. The PLOT and UNPLOT commands also change the color of 
individual pixels as already explained. 

The best way to learn to draw pictures with the computer is to experiment 
with it yourself. Imagine how you might use the computer's symbols to draw 
a picture of a person, animal, or object. À few examples will help you begin. 
The following one draws the outline of a die with three dots on it: 


је PRINT AT а. 

га PRINT AT 1, 

Be PRINT AT =. 

за PRINT ӨТ 3. 

Se PRINT HT +. 

ва PRINT AT 5, 

"а PRINT AT Е, 

за PRINT AT 7, 

ас PRINT РТ 8,12; ' " 
1209 PRINT AT z,iz; *";HT 4,14)” 
"OAT 6,18; "=" 


Line 10 uses the graphics symbol on the 6 key. Lines 20 through 80 use the 
symbols on the 5 key (after the first quotation symbol) and on the s key (just 
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before the last quotation symbol). Line 90 uses the symbol on the 7 key. After 
you run this program, the screen will look like this: 


Notice that the PRINT statements themselves form a figure that looks like 
thefigurethe program produces when it runs. This is not always so because 
a PRINT statement may sometimes be too long to fit on one line. 

If your system includes a Timex or Sinclair printer, replace the PRINT 
commands with LPRINT commands to print the figure on the printer. Alter- 
natively, leave them as PRINT commands, run the program, and use the copy 
command to transfer the result to the printer. If you have a different printer 
designed to work with the ZX81 or TS1000, use the commands specified by 
the printer's manufacturer. 

The next program draws a picture of a cat: 


ЛАЛЕ FU pe 
Ey S ES P CLIE Fg 
T1 TI TI TI TI TI T1 


His name is Cheops, and he was a favorite of the builder of the great pyramid: 


IG = - а * =” 
ee PRI i “". 

за PRINT © X Эа 

ig PRINT © ца a 
ба PRINT ^" s Re 
se PRINT "E y 
78 PRINT " s 


Obviously, you eannot draw a completely realistic picture with this small 
set of graphies symbols. With a little effort, though, you can represent just 
about any object you want. 
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computer performs calculations like a caleulator and prints 
text like a typewriter, but it is much more than just a calculator 
and a typewriter combined. A computer can test the result of a 
caleulation or a keyboard entry and determine what it should do next. It can 
repeat the same section of a program over and over until a specified condition 
is satisfied, or it can skipone partof a program to execute another part. This 
chapter tells you how to use these decision-making capabilities in your pro- 
grams. It also describes how to organize large amounts of data in tables and 
similar groupings, called arrays, to make the best use of these powerful 
capabilities. 


SKIPPING AROUND WITH GOTO 


Up to this point this book's programs have simply been lists of commands 
for the computer to execute in exactly the same order as they are numbered. 
The line numbers tell the computer that these commands are part of a 
program, and specify their order of execution. Such a program could be 
diagrammed like this: 
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In many eases, however, a program needs to perform one operation over 
and over with few or no changes. Alternatively, it may need to perform 
different operations, depending on what is input from the keyboard, or 
depending on the results of calculations. Thesimplest BASIC command that 
changes the flow of a program is the сото command. It instructs the comput- 
er to skip forward or backward to a specified line number, like this: 


10 
Gara 


50 


Се 


Thus the line numbers perform an added function: They not only specify the 
order of statements in the program, but also serve as addresses for GOTO 
commands. A GoTo statement branches or jumps to a new line number. These 
terms simply mean that instead of proceeding to the next program line after 
GOTO, the computer skips to the new line number specified in the сото 
command and resumes execution there. The new line number can be a 
constant, a variable, or a mathematical computation. If there is no line with 
that number, the computer jumps to the nearest existing line number that is 
higher than the specified number. 

Programs use the GoTo statement for two purposes: to repeat an operation, 
or to skip sections of a program. The following sections describe these two 
uses of GOTO. 


Repeating a Program Section 


To repeat a section of a program, insert a GOTO statement at the end of the 
section. The GoTo statement must specify the number of the line at the 
beginning of the section to be repeated. An example is the following program 
to calculate square roots: 


= 2104 
18 РЕМ DEFINE A STARTING VALUE 
20 LET Я=1 
за REM THE REPEATED SECTION BE 
BINS HERE 
40 РЕН FRINT THE SSURFE ROOT 
Se PRINT "THE SOURRE FOOT GF 
| 
Бе РЕМ INCREASE THE NUHBER БУ 
INE 
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-d 


ur C 
a far 


This program prints the square root of each integer, starting with one, until 
thescreen fills up and the computer stops with error code 5. If you now enter 
CONT, the computer clears the screen and fills it again with the square roots of 
the next integers. You can use the BREAK key (the same as the SPACE key) to 
stop the computer at any point, and you can use CONT to resume from that 
point. 

A repeated program section is called a loop. In the above example, the 
program loops between lines 50 and 90. Loops are extremely useful in 
computer programming, and you will encounter them often in the pages that 
follow. 

Since the computer ignores REM statements, you could use coro 30 or coro 
40 in line 90, instead of coro 50. However, because a REM statement takes up 
time, the program will run faster if you use GOTO 50. 

The following example repeatedly simulates the throw of a die until the 
screen is full: 


= SLO 

= RAND 

ла PRINT THT :cxEHD-i! 
se пт 18 


With this form of the program, you can easily generate a large number of 
throws without having to run the program over and over. To get even more 
throw results per screenful, you can modify the program to PRINT several 
numbers per line, like this: 


f raum 
т 
T 
Hi 
1 


nire 


Now the screen fills with 16 numbers per line instead of only one. You can 
print more or fewer numbers per line by changing the length of the blank 
string at the end of line 10. Try it with no spaces and then with two, three, or 
four spaces. Since each line has 32 columns, the numbers will not line up 
directly under each other unless the combined length of the random number, 
plus the spaces after it, divides evenly into 32. 

The next example of a loop converts the "blink" animation program from 
Chapter 4 into a display like a flashing billboard: 


ја 2:04 

га PRINT HT 8,5 
за PRINT AT 82,5 
48 PRINT РТ 2,5 
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са PRINT BT 0,5: E 
ве PRIMI AT 0,5, "E 
та PRINT AT 2,5: E 
га сага га 


Since this program keeps printing in the same spot, it never fills the screen, 
and so will continue looping until you press the BREAK key. Use this kind of 
animation to call attention to a particular part of the information displayed 
on the screen. For example, it could highlight a prompt that tells the user 
what input the computer expects next from the keyboard. 


Sklpping Part of a Program 


A program may need to do different things, depending on the result of a 
calculation or input it receives from the keyboard. Chapter 3 introduced the 
IF and THEN keywords for testing whether two numbers or numeric expres- 
sions are equal. This section will explain how to combine this test with the 
GOTO statement so that your programs can make choices. 

As an example of program control employing IF, THEN, and GOTO, consider 
a program that requests two numbers as input, divides the first by the 
second, and prints the result. Without any added control statements, the 
program is as follows: 


ig БЕН ШЕТ HLiHBERS FEON EEYDOA 
EL 

Ee 

42 

саз 

se | 

тар 
муына 


Run this program several times, entering different numbers to see how it 
works. Then enter zero for NUM2. The computer stops at line 70, reports 
error code 6, and does not print a quotient. Since the rules of arithmetic make 
it impossible to divide by zero, a good program should test the divisor to 
prevent such errors. The following improved program tests NUM? first. If it 
is zero, the program prints an explanatory error message and omits the 
division: 


а REM SET NUMBERS FROH КЕУБОН 


+ 


RE 
Ес PRIMT CENTER NUMBER” 
ір INPUT МОН; 
ао PRINT CENTER HUMEER" 
со INPUT HUME 
ба IF НЫМЕ=а THEN ize 


Chapter 6: Program Control 109 


70 REM CIVICE AND PRINT RESULT 
за PRINT "THE QUOTIENT IS "¡NU 
ма -HuMe 
за РЕМ SKIP ERROR MESSAGE 
теа COTO 138 
118 REM PREUENT DIVISION BY ZER 
Li 
с 120 PRINT "YOU CANNOT DIVICE BY 
A 2 '' 


ZERO 
9 130 REM 


Run the improved program, entering some nonzero numbers to verify that it 
still works as it did before. Then enter zero for NUM2 and observe how it 
handles the problem. 


THE STOP COMMAND 


Another command for controlling the flow of your programs is the STOP 
command (sHIFT-A). It makes the computer stop the program and display the 
El cursor. You can also stop a program by pressing the BREAK key, but the 
STOP command assures that you will stop at a specific line. To see one use of 
sroP, modify the blinking billboard program as follows to check for a pressed 
key and stop if one is not pressed: 


ја 3LüOL 

га PRINT AT 2,5) "BLINK 
за PRINT AT 8,2: LINE 
dd PRINT AT 8,5; "БІНЕ 
50 PRINT AT 0,5: вв 
ва PRINT HT 8,5." UBL ПК“ 
та PRINT AT 9,5: "BLING" 


75 IF IMKEYS$-^" THEN STOP 
se GOTO га 


When you enter RUN forthis program, keep your finger on the ENTER key so 
that the computer will find a key pressed when it reaches line 75. In this way, 
INKEYs will receive the ENTER code instead of the empty string, and the 
program will loop back to line 20. When you remove your finger, the new 
value of INKEY3 will be the empty string. The program will stop with the last 
letter of BLINK in reverse video. By moving the те statement to other places in 
the program, you can make it stop with a different letter reversed, or with 
none of them reversed. 


COMPARISONS AND DECISIONS 


The 1F-THEN statement is the principal decision-making statement in 
BASIC. Between the words IF and THEN is a condition for the computer to 
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test. After the word THEN is another BASIC command for the computer to 

execute if the condition is true. If the condition is false, the computer ignores 

the command after THEN and goes directly to the next line of the program. 
Some examples of the IF-THEN statement from previous sections are: 


IF INEEYS="" THEN STAF 
IF НУНЕ=а THEN бота ile 
IF TEST-i THEM PRINT "UNITY" 


The command to the right of THEN can be any other BASIC command. If it 
is a GOTO statement, and the “if” condition is true, the computer will skip to 
the line number specified after GOTO and execute that section ofthe program. 
If the command to the right of THEN is not a GOTO statement, then the 
computer will always execute the lines directly below, and the condition only 
determines whether the computer will execute or skip the one command to 
the right of THEN. 

АП of the examples above use the same type of conditional test. They test a 
variable to determine whether it is equal to a particular value. The symbol 
they use for equality is =, the same symbol that the LeT statement uses to give 
a value to a variable. These two uses ofthe =symbol are really very different, 
however. The computer chooses the correct meaning by examining the first 
keyword in the command. If the keyword is LET, the computer must give a 
value to a variable. If the keyword is 1F, it must compare a variable to a 
specified value. 


Relational Tests 


The TS1000 and ZX81 recognize six different kinds of relational tests. The 
"equality" test just discussed is one of these six. The computer can also 
determine which of two numbers is larger. It can even understand such 
combined relationships as “not equal” and “greater than or equal to." The 
different relationships between variables that the computer can test, and the 
symbols for these relationships, are shown in Table 6-1. Each of these com- 
parison symbols is a single symbol, located on a single key. For example, <= is 
a shifted symbol on the R key. Do not type two separate symbols, < and =, 
instead. 

Use each of these symbols in the same way you use the = comparison. For 
example, the following program prints the string BUY IT if the value of the 
variable PRICE is smaller than the value of the variable LIMIT: 


PRINT 
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Table 6-1. Relational Operators 


Operator Meaning 


Equal 

Less than 

Greater than 

Less than or equal to 

Greater than or equal to 

Not equal to (means the same as "less than or greater than") 


AVA 
vau V^ 


The computer can perform relational tests on strings as well as on numbers. 

For numbers, the meaning of such comparisons as “equal,” “larger,” and 

“smaller” is obvious. For strings, however, these words do not have a familiar 

meaning. To explain them, we begin with the concept of string equality. Two 

strings are equal if they have exactly the same characters in the same order; 

in other words, they are equal if they are exactly alike. Obviously, then, two 

strings of different lengths cannot possibly be equal. Some examples of 

string equality and inequality are shown in Table 6-2. The last pair of strings 

is unequal because they have different numbers of spaces between the words 
PERSONAL and COMPUTER. 

f Two strings can even look exactly alike on the screen and still not be equal. 

For example, one of them could have an extra space at the end, or one could 

| use a special BASIC word while the other spelled out the same word with 

letters. To demonstrate the second possibility, enter the following program. 

| Use SHIFT-S for the string LPRINTin line 10, and type out the individual letters 

of LPRINT in line 20: 


A 


Tid 
ВАС Cn EI 


ie 
55 
5 
ұй 
B. 


The computer prints NOT EQUAL because the two strings have different 
representations inside the computer, even though they look alike on the 
screen. The first string consists of the single character code 225, which 
represents the command word LPRINT (see Appendix C). The second string 
consists of the character codes for the individual letters in the same word. 


Table 6-2. String Equality 


First String Second String Are They Equal? 
MASSACHUSETTS MASSACHUSETTS Yes 
BACON AND EGGS BACON AND EGG No 
PERSONAL COMPUTER PERSONAL COMPUTER No 


o TTT 
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You can test the result of an INPUT statement to determine whether the 
person running your program entered a particular string. The following 
program will either divide or multiply two numbers, depending upon the 
input: 


HUMBER” 


MOHI 
CENTER SECOND HUME 


This program asks a question in line 70 and uses the = comparison on strings 
to analyze the answer. If you enter YES, then the command coro 130 in 
90 is executed. The computer skips the division in line 110 and performs the 
multiplication in line 130. If you enter anything other than YES, the comput- 
er skips the command coro 130 in line 90 and performs the division in line 
110. Then line 120 branches to line 170, skipping the multiplication. 
Unfortunately, this program is not very tolerant of mistakes. If you mis- 
{уре the string Y ES, it will assume that you meant NO. We will fix this later. 
In BASIC, the “smaller” of two strings is simply theonethatcomesfirstin |) 
alphabetical order. For example, observe what happens when you execute || 
* the following command: ! 


iF' FRED ШІМ" TREN SRINT “LEE 


The computer prints LESS because FRED comes before JIM in alphabeti- 
cal order. Notice that the < and > comparisons for strings have nothing to do 
with the length of the strings. A shorter string can come either before or 
after a longer string in alphabetical order. In BASIC’s string < and > compar- 
isons, only the alphabetical order matters. Try the following program, which 
reads two strings from the keyboard and prints them in alphabetical order: 


ig INPUT AG 
га INPUT Бф 
де IF вфенф THEM GOTO Fe 
аа РБІМТ A$ 
50 FRINT B$ 
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ва STOF 
78 PRINT BS 
за PRINT A$ 


Logical Expressions 


Recall that numeric variables and constants combine with numeric opera- 
tors like +, -, », /, and * to produce numeric expressions, and that strings 
combine with various operators to produce string expressions. In the same 
way, relational tests combine with logical operators to produce new tests. 
Such combinations are called logical expressions. The operators that appear 
in logical expressions are AND, OR, and Nor. The following program illustrates 
the AND operator: 


10 INPUT A 

а INPUT Б 

за INPUT C 

4@ INPUT E 

50 IF A=B AND CzD THEN PRINT 
BOTH PAIRS ARE EQUAL” 


Run the program several times, entering different numbers for A, B, C, and 
D. The computer prints BOTH PAIRS ARE EQUAL only if A is equal to B 
and C is equal to D. 

To illustrate the or operator, modify line 50 in the previous program so that 
the program becomes 


іс INPUT 
го INPUT 
за INPUT 
40 INPUT 
50 IF Б-Е UFR С 
T LEAST ONE РАЈЕ 


mcm T 


THEN PRINT “A 
EQUAL” 


The computer will print its message if A is equal to B or if C is equal to D. It 
will also print the message if both equalities are true. 

The operator мот is slightly different from or and AND because it refers to 
just one relational test instead of two. The following program illustrates the 
NOT operator: оо A 
cg 36 ISA <7 8 "en Sed. enfer 
ја INPUT Б ` 
ве ТНРУТ E 
30 IF WOT ASB THEM PEINT "HOT 


Notice that NOT goes in front of the expression to which it applies. Think of 
NOT as a function that takes a relational expression as its argument, evaluates 
itas true or false, and uses the opposite of the result as its value. Every logical 
expression employing NoT has another, equivalent form without Nor. For 


NN <KA A 2  —— ино 
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example, the following line does exactly the same thing as line 30 above, but 
without using NOT: 


Use NoT whenever it makes logical expressions easier for you to write or 
understand. 

The logical operators AND, OR, and NOT have their own relative priorities, 
just as the different numerical and string operators do. The highest of the 
three is мот, followed by AND and or in that order. For example, the following 
command will cause the computer to stop if À is not greater than B or if C is 
equal to D: 


-- 


Е 


т .:--- ТА 
HE һит 


You can use parentheses to specify different priorities, just as you сап with 
numeric and string expressions. The following command does exactly the 
same thing as the previous one: 


= то от Cp clin Toa, z 


T -- 
ai Pia — 


The next command causes the computer to stop if either ^A is greater than 
B" or "C is equal to D” is false: 


т= и шош т - 7 ==: = 
ТЕ ~ = НЕ zu ATOE 


In simple expressions, the logical operators generally mean just what you 
would expect the English words AND, OR, and NOT to mean. However, in 
compound expressions, spoken English takes shortcuts that the computer 
will not understand. For example, the English sentence ^X is larger than Y 
ог Z” actually means that two things are true: “X is larger than Y" and ^X is 
larger than Z." In BASIC you must express this idea as two relations joined 
by AND, like this: 


Zo.” А — 
Ton L 


If you tried to copy the English sentence directly, you would write 


~ 
= 


LB 


хуу 


In BASIC this last expression can only mean ^X is larger than Y, or Z is true," 
which is quite different from the original sentence. 

The logical operators AND, OR, and NOT are also called Boolean operators, in 
honor of a mathematician named Boole who studied their properties in 
detail. These operators make it much easier to tell the computer what you 
want and to keep track of what you have told it. For example, we can improve 
the program that selects either division or multiplication by comparing the 
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inputstring to NO as well as to Y ES, and printing an error message if it is not 
one of these two. The new test uses the or operator, as follows: 


ETE TE eX 
ТЕКЕ 


Xp mum 


aL 
Џ 


ПА a а TI TI 


re 


| : ШЕ DEZ 
pi ; ва 

PRINT CENTER ТЕЗ ЈЕ 

GOTO Fe 

ТЕ Ба у 

БЕМ Do u 

LET аяныш! 

вата 179 

LET ANS =H 

РЕМ FRIN Н 

PRINT “THE AHSWER 


FOR-NEXT LOOPS 


A loop is just a section of a program that the computer repeats. When a 
GOTO statement branches back to an earlier part of the program, it produces 
a simple loop. Some loops use a relational test to determine when to quit 
looping. The blinking billboard program that you used before is an example 


of such a loop: 


ла SLOL 

20 PRINT AT 2,5; "BLINK" 
за PRINT AT ae 
40 PRINT AT 0.5. “BRINE” 
50 PRINT AT ERE ae 
ва PRINT AT 0.5: "ві к" 
та PRINT AT 8,5; ‘BLING 
75 IF_INKEY $="" THEM STOP 
за GOTO 20 


Loops can terminate in several different ways. In many cases, the pro- 
grammer specifies exactly how many times a loop will be executed. Such a 
loop requires an additional variable, called a control variable or a counter, to 
keep a running count of the number of passes through the loop. For example, 
the following program moves a reverse-video character through a word 15 


times: 
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за PRINT AT 82,5. 
да PRINT AT 2,2; " 

за PRINT AT 2,5; " 

50 PRINT HT 2,5; " 

78 PRINT HT à8,5;" 

qua ey жер 

за IF Сішіс THEN GOTO га 


Line 12 initializes the control variable C. That is, it defines C as a variable 
and gives it its starting value. Each time the computer goes through the loop, 
it encounters line 75 and increases the value of C by 1. Then line 80 sends it 
back to line 20 to repeat the loop. After the fifteenth pass, C will be equal to 16 
and the coro in line 80 will not get executed. Thus the computer does the loop 
exactly 15 times and then goes on to the next line of the program. 

Counting loops are so common that BASIC provides two special commands 
for writing them: the For statement and the NExT statement. The For state- 
ment always goes at the beginning of the loop, and the NExT statement always 
goes at the end of the loop. You can use these commands to simplify the 
blinking billboard program in the following way: 


i8 зы 
12 FD 
20 PR 
за ER 
48 ER 
ze ER 
52 ER 
78 PR 
50 HE 


The For statement instructs the computer to begin a loop, using a specified 
control variable (called C in the above program) as the counter. It also 
initializes C to 1 and specifies that the loop terminate and the computer go on 
to the rest of the program when C becomes greater than 15. The number 1 
after sTEP tells the computer to add one to C each time it gets to the end of the 
loop. Thus the FOR statement does almost all of the work required to create a 
loop. 

The NEXT statement in line 80 simply marks the end of the loop, the place 
where the program loops backward or moves forward, depending on the 
current value of the control variable. 

The name of the control variable of a FoR-NEXT loop must be justa single 
letter. The number after STEP can be any numeric expression. It specifies the 
change in the control variable at the end of each loop. If you omit sTEP and the 
number after it, the computer assumes a S one. For example, the 
following two FOR statements will do exactly the same thing: 


TE CE ES Sree 2 
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The sTEP size can also be negative, in which case the number after To must 
be smaller than the number before To. The STEP can even be a fraction. The 
loop will terminate as soon as the counter passes the value specified in the FoR 
statement, whether it hits the value exactly or not. 

The next example of a FOR-NEXT loop uses a program from Chapter 3 that 
calculates compound interest for two quarters. Theoriginal program was the 


following: 
ic ШШЕТНа 100 
5а ; ^ 
ac 
аг 
ze 
е8 T ЗОРТНЕНОРТН+ I 
зо ыт RTH 


Observe that lines 60 and 70 are identical to lines 40 and 50. To calculate 
the value of the investment after, say, 20 quarters, you would have to dupli- 
cate this pair of lines in the program 20 times. With a FOR-NEXT loop, however, 
you can repeat this pair of commands any number of times without retyping 
them, and you can read in the number of quarters as a variable. The following 
improved program works equally well for any number of quarters: 


= PHI! 

= INFL 

= eae 

ШАН e rii A 
z es 

SA == 

- ~ Ju NT | 

За FOR TO HGURET: 

Ер LET INTEREST =QRATE+LORTH 
CEP СЕТ ОРТН=НОРТН+ТНТЕБЕЗТ 
= мүт H 

"= ЕЖЕ I 

BE PRINT WORTH 


USING THE CONTROL VARIABLE 


The control variable of a FOR-NEXT loop is more than just a counter. You can 
also use it inside the loop to determine which pass through the loop is in 
progress. For example, to print out the number of each quarter together with 
the worth at the end of that quarter, insert the following line in the previous 
program: 


PRINT "UQRTH AFTER QUARTER 
IS "; LORTA 


There are two things you must never do with the control variable, however. 
Never try to change its value with a LET or INPUT statement inside the loop, 


NN === ош 
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and never use GOTO to branch into the middle of a FOR-NEXT loop without 
executing the FOR statement. After such a branch, the computer would be in 
the middle of the loop without having defined the control variable. 

To understand other uses of the control variable of a FOR-NEXT loop, begin 
with the original version of the blinking billboard program, without any 
loops: 


іш 5:04 

га PRIHT AT 8,5, 
за PRINT AT 8,5: 
42 PRINT AT 0,5; 
Se PRINT AT 0,5; 
Be PRINT BT 4,5; 
та PRINT HT @.5; 


Observe that lines 30 through 70 are identical, except that each line has a 
different character in reverse video. For a longer word than BLINK, it would 
be inconvenient to use a separate program line for each character position іп 
the word. A much simpler program would use a FOR-NEXT loop to go through 
the word one character at a time, reversing that one character, printing the 
resulting string, and then unreversing the character to prepare the string 
for the next pass through the loop. Such a revised program follows: 


із 5101 

22 LET пф="Е ТЕ" 

за PEINT AT 0.5, A$ 

44 FOR ксі TO LEN A$ 
НАЕ LET ЯФІКІ=СНЕФ {СОСЕ Я$(К!+ 
231 

ва PRINT AT 2,5:8% 

“A LET НЕК SCHR (CODE n$ikK!)- 
128: 

за NEXT К 


Line 20 defines a variable А$ in order to avoid re-entering the word 
BLINK several times. Line 30 prints the string with no reverse-video char- 
acters. Then line 40 begins a loop that is executed once for each character in 
the string. 

Lines 50 and 70 do most of the work. To understand them, first find the 
character code for the letter в in Appendix С. Its number is 39. Now add 128 
to 39 to get 167, and look up that character in Appendix C. You will find that it 
is El, the reverse-video version of character number 39. Look down the list 
and observe that each of the single characters (codes 0 to 63) and its reverse- 
video counterpart differ by exactly 128. Line 50 in the above program simply 


1. Takes the character code for the character (CODE А$К)). 


2. Adds 128 to obtain the character code for the corresponding reverse- 
video character. 
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3. Uses the curg function to convert the result to the reverse-video charac- 
ter itself. 


4. Uses string substitution to replace the original character with the 
reversed one. 


Line 60 prints the string with the reversed character in it, and line 70 
undoes what line 50 did, to leave the string the way it was originally. 

Runthe program to verify that it does thesamething theoriginal program 
did, only more slowly. It should move the reverse-video character through the 
word BLINK once, from left to right, leaving the Y reversed. 

This latest version of the blinking billboard program is not actually much 
shorter or simpler than the original version. With a longer string in the place 
of BLINK, however, theoriginal version would require an additional line for 
each added letter. The new version of the program needs no more program 
lines, regardless of how long the string is. In fact, its biggest advantage is 
that it will work for any string at all. To prove it, replace line 20 with the 
following: 


га LET H$z'"THIS IS A LONGER 57 
RING" 


Now run the program and watch the reverse video move across this longer 
string. Replace the string in line 20 with your name, or with any other string 
you want to use. 

Thus, a well-designed loop makes a program more general, eliminating 
any dependence on the particular piece of data it uses. To make the program 
even more general, replace line 20 with an input statement that lets you 
choose the string each time you run the program, like this: 


20 INPUT A$ 


Loops Within Loops 


To make the blinking billboard program repeat the motion across the 
string several times, as it did before, simply add another set of FOR-NEXT 
statements. The resulting program has two loops, shown with brackets in the 
following illustration: 


10 SLOW 

20 INPUT A$ 

25 FOR C=1 TO 15 

30 PRINT AT 0,5;A$ 

40 FOR K=1 TO LEN A$ 

50 LET A$(K)=CHR$ (CODE A$(K)+128) 
60 PRINT AT 0,5,A$ 

70 LET A$(K)=CHR$ (CODE A$(K)+128) 
80 NEXT K 

9) NEXTC 
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This program is an example of nested loops, which just means one loop inside 
another. The brackets at the left side of the listing show you where each loop 
begins and ends. The outside bracket connects the FOR and NEXT statements 
that use C as their control variable, and the inside bracket connects the FOR 
and NEXT statements that use K as their control variable. The INPUT state- 
ment (Line 20) comes before both loops, because you only want to read the 
string once. 

Observe that the loop with control variable K is completely inside the loop 
with control variable C. This illustrates a very important rule for nested 
loops: They must not overlap. In other words, if you drew the connecting 
brackets from the beginning to the end of each loop, they must not cross each 
other. Draw such brackets when you are designing nested loops to make sure 
they obey this rule. À program can have any number of separate loops, one 
after the other, and it can have many loops inside each other, as long as no 
brackets eross. The following example shows an "illegal" loop: 


50 FOR I=1 TO 10 
60 FOR X=25 TO 347 STEP 3 


100 NEXTI 


200 NEXT X 


Loops That Go Backward 


Previous examples of loops have added oneto the control variable each time 
through the loop. You can specify a different amount of change in the control 
variable by including sTEP in the FoR statement. For example, if you switch 
the first and last values of the control variable and make the step negative, 
the loop will run “backward.” In the blinking billboard program, such 
changes in the inner loop will cause the reverse-video character to move 
across the line from right to left, instead of from left to right. Run the 
following modified program and watch the animation go in the opposite 
direction: 


18 SLON 
20 INPUT As 

25 FOR C-1 TO 15 

за PRINT AT @,5; 9$ 

48 FOR K=LEN AS TO 1 STEP -i 
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S50 LET H$iHizcHRES$ (CODE АФК) + 
128! 

ва PRINT РТ 0.5, A$ 

YO LET $: Е! =СНЯ$ (COACE AiK- 
1251 

за NEXT к 

acd WEST С 


A similar change in the outer loop (the one with control variable C) would not 
change what the program does because the program never uses C for any- 
thing inside the loop. 

To illustrate the effect of sTEP in another way, substitute the following for 
line 40: 


dd FOR A= EN AS TO i STEP -2 


Now only every second character in the string will get reversed. The control 
variable that chooses the characters to be reversed by line 50 is now changing 
by two each time through the loop, and the loop only runs half as many times 
as it did before. Try different values of STEP until you are sure you understand 
it. 

When writing loops, you must make sure that the step changes the control 
variable in the right direction. The following program, which prints the 
numbers from 5 to 10, clearly shows what the different parts of the FOR 
statement do: 


із 
ас 


ло 
шай 


Interchange the 5 and the 10, changing sTEP to —1 at the same time, and the 
program will print the same numbers backward, starting with 10 and going 
to 5. To see this, run the following program: 


го PRINT G 


However, if you switch 5 and 10 without changing STEP, or if you make STEP 
negative without switching 5 and 10, the program will not print anything at 
all. Try the next two programs: 


PRIHT È 


19 FOR 8-10 ТО = 
22 
38 NEXT G 


12 FOR сшв TO 18 ЕТЕР -1 
0 PRINT & 
за NEST G 
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ARRAYS 


Table 6-3. Rules for FOR-NEXT Loops 


The control variable name must be a single letter. 

The NEXT statement must use the same control variable as the FOR statement. 

The FOR statement must be executed before the NEXT statement. 

GOTO cannot be used to jump into the middle of à FOR-NEXT loop. 

The value of the control variable cannot be changed with LET or INPUT while 

inside the loop. 

6. Multiple loops can be separate or nested, but they cannot overlap. 

7. If the final value of the control variable is larger than the starting value, then 
STEP must be positive. 

8. If the final value of the control variable is smaller than the starting value, then 

STEP must be negative. 


тт ого; 


You cannot go from 101о 5 in steps of 1 because you're already past 5 when you 

start. Similarly, you cannot go from 5 to 10 in steps of —1 because you're 

already past 10 (that is, smaller than 10) when you start. The computer knows 

that a negative STEP means going to smaller values of the control variable. If 

thestarting value is already past the limit, it will just ignore the loop entirely. 
The rules for FOR-NEXT loops are summarized in Table 6-3. 


Arrays аге a systematic way of naming a large number of variables. If you 
do not already understand what arrays are, or how to usethem, then read on. 
The information that follows will be very important to your programming 
efforts. 

Arrays are a useful shorthand means of describing a large number of 
related variables. Consider, for example, a table of 200 numbers. How would 
you like to assign a unique variable name to each of the 200 numbers? It 
would be far simpler to give the entire table one name and identify individual 
numbers in thetable by their location within the table. This is precisely what 
an array does for you. 

When you have two or more data items, instead of giving each data item a 
separate variable name, you can give the collection of data items a single 
name. The collection is called an array, and its name is an array name. The 
individual data items in the array are called array elements or members of the 
array. The elements in an array are numbered. In this way you can select an 
individual item using its position number, which is referred to as its index. 

As an example of array usage, consider how you might keep track of 
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individual scores in a bowling tournament. You could use a separate variable 
name for each bowler, like this: 


ЕЕЛЕЛЕЗЕЗЕЛЕЗЕЛЕЗЕЗ 


RAY LEO IDA JAN SUE TED JIM LOU ART DEE 


But what do you do at the next tournament, where the bowlers have different 
names? 
How about keeping the scores in an array, like this? 


В(1) B(2 B(3 B(4) B(5) B(6 В(7) В(8) B(9) B(10) 


The array name is B. (The name of an array must be a single letter.) Each 
element in this array will be one bowler's score. An index (enclosed in 
parentheses) follows the array name. Thus a specific data item (that is, one 
bowler's score) is identified by an array name and an index. For example, 
B(3) has the score for bowler number 3. 

The TS1000 and ZX81 also provide for arrays of strings as well as arrays of 
numbers. Thus, if you wanted to, you could have two arrays: one array of 
numbers for the bowlers' scores and one array of strings (call it N$) for the 
bowlers' names, like this: 


Во) B(2 B(3 В(4) B(5 В(6) B(7) B(8) В(9) B(10) 


ШЕШШШІШЕП Tes 


N$(1) N$(2) N$(3) N$(4) N$(5) М%(6) N$(7) №$(8) N$(9) М%(10) 


Dimensioning Arrays 


To illustrate how to use arrays, begin with just one array, an array of 
numbers. First, you must tell the computer that B is an array, and how many 
elements B has. You do this with a DIM statement; DIM stands for dimension, 
which means the size of the array. Suppose that the program may have to 
store scores for as many as ten bowlers. Before you can use the array, you 
must have the computer execute the following DIM statement: 


DIM Brida: 
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This DIMstatement creates ten variables. The first one is B(1), thesecond one 
is B(2), and so on up to B(10). The рім statement also gives the value zero to 
each of the ten variables in the array. (Most BASIC computers would also 
create a variable B(0). The TS1000 and ZX81 do not.) 

You can have both a single variable called B and an array called B if you 
want to, as long as you don't get them confused. The computer will keep them 
straight because it knows that numeric array elements must include an 
array index in parentheses. 


Putting Data into Arrays 


You can use a FOR-NEXT loop to enter the bowlers' scores into an array, and 
another FOR-NEXT loop to print them. The program to do all of this follows: 


i БІН 21105 

= FOR Іші To 14 
іс INPUT BII 

iz НЕХТ I 
га FOR Е=1 To іс 
ва PRINT Bik} 
УӘ NEXT E 


Notice that variables (or even more complicated numeric expressions) can be 

used as the array index. This makes it easy to use arrays with FOR-NEXT loops. 
Enter the following ten numbers to use as input to this program. Then RUN 

the above program and type in these numbers, following each by ENTER: 


After you enter the tenth number, the program simply prints out the list of 
numbers in the same order in which you entered them. 
This program isn’t particularly exciting, but it provides a good example of 
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how arrays work. Once the numbers are stored in an array, you can do many 
other things with them besides just printing them. For example, you could 
arrange the bowling scores in numerical order and print them out that way, 
from the lowest to the highest. Arranging data items in order is called 
sorting. 


Sorting Array Elements 


If you haven't done so already, enter the entire bowling score program 
(lines 1-70), run it, and enter the sample data. You can now use the data in 
array B to illustrate a sorting program. Besides being useful in its own right, 
the sorting program will show you more about how to use arrays. 

This program will work in a very simple way. It will go through the array 
of numbers, one at a time, comparing each number in turn with the one that 
follows it. If the second number is smaller than the one before it, the program 
willswitch the two numbers so that the smaller one comes first. After it does 
this once, the numbers will be closer to being in order than they were to begin 
with, although they may still not be in perfect order. If we repeat this process 
enough times, the numbers will eventually be sorted perfectly. 

We begin with a program to go through the array just one time, switching 
adjacent pairs of numbers that are out of order. It is like the previous 
program, but with lines 20 through 45 added: 


1 DIM Bie 

5 FOR Ісі TO іс 

да INPUT BII! 

12 NEXT I 
га FOR 1-і TO 3 
25 IF BiJdiszBEBiJ«1)! THEN GOTO 4 


за LET TEMF=E 10; 

35 LET BEidizsBidsel? 
48 LET Eid¢l1) =TEMP 
45 МЕХТ d 
Sa FOR E= 
ва PRINT 
TO NEXT Е 


і Tū 14 
БІК 


Notice how lines 30 through 40 use а temporary variable to contain the old 
value of B(J). Otherwise, there would be no way to get it back after line 35. 
Statement 25 skips the switching statements if the pair of numbers is already 
in the correct order. 

If you have already entered the ten numbers into B, use coro 20 instead of 
RUN to start the program. If not, use RUN and enter the numbers as given 
above. In either case, the program will print the same numbers you origi- 
nally entered, but in a different order, as shown in Table 6-4. 

The program switched the first and second numbers, the third and fourth 
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Table 6-4. Results of a Simple Array Program 


Original Order New Order 


158 147 
147 158 
171 135 
135 171 
172 170 
170 172 
195 195 
231 215 
215 231 
268 268 


numbers, and several other adjacent pairs. The new list is closer to being in 
order than the original one was, but it isn't perfect yet. 

The numbers are still stored in the array B, but in the new order. Enter 
GOTO 20 again, and the program will switch some pairs again to produce a 
still better order. Finally, enter Goro 20 one more time and you will see a 
perfectly ordered list, from the smallest to the largest. 

To make the sorting completely automatic, you can put it inside another 
loop that does what you did when you ran the program several times. This 
extra loop will keep repeating thesorting procedureuntil the entire list is in 
order: 


Statement 47 keeps branching back to statement 15 until the numbers are all 
ordered. Of course, the program has to have some way of knowing whether 
theordering is finished at the end of each loop. To do this, the program uses a 
variable called SWITCH. At the beginning of each pass through the list of 
numbers, statement 15 gives SWITCH the value zero. If the list is not 
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perfectly ordered, line 27 will get executed at least once. At the end of the 
pass, at statement 47, SWITCH will nolonger bezero, and the computer will 
branch back for another pass. When the ordering is complete, statement 27 
will not be executed any more. SWITCH will still be zero when line 47 is 
executed, and the computer will quit branching and print the results. 

To use this program, enter RUN and re-enter the list of numbers in the 
original order, or any ten numbers you want to try. The computer will print 
them in order. 


Multi-Dimensional Arrays 


Array B in the sorting program has only one index, so it is called a one- 
dimensional array. The T81000 and ZX81 can handle arrays of any number of 
dimensions, provided enough memory is available. A one-dimensional array 
isatable with justone row of numbers. The bowling scores just discussed are 
an example: 


а | ма | па | | г] о | 5 | г | 25 | 


В) B(2 B(3 В(4) В(5) В(6) B(7) B(8 В(9) В(10) 


The index identifies a number within the single row. An array with two 
dimensions is like an ordinary table of numbers with rows and columns: one 
index identifies the row and the other index identifies the column. 

Let's extend the bowling tournament example to two dimensions. Suppose 
there are four teams, each with ten bowlers. The tournament could be 
represented by one two-dimensional array, like this: 


B(4,1) B(4,2) B(4,3) B(4,4) B(4,5) B(4,6) B(4,7) B(4,8) B(4,9) B(4,10) 
B(3,1) B(3,2) B(3,3) В(3,4) B(3,5) В(3,6) B(3,7) B(3,8) B(3,9) B(3,10) 
B(2,1) B(2,2) B(2,3) B(2,4) B(2,5) B(2,6) B(2,7) B(2,8) B(2,9) B(2,10) 
B(1,1) B(1,2) B(1,3) B(1,4) B(1,5) B(1,6) B(1,7) В(1,8) B(1,9) B(1,10) 


________ A AA AAA A AA AAA,  áúll SS a 
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The first index of the two-dimensional array is the team number and the 
Second is the bowler number on that team. So B(3,2) would be the score of 
bowler 2 on team 3. To create such an array, you would use a DIM statement 
like this: 


DIM Bid IO 


String Arrays 


The TS1000 and ZX81 can also work with arrays of strings. In fact, a 
string is already very much like an array of characters, except that it does 
not require a dimension statement. Recall that a statement like 

PRINT Я$:2; 
is a short form of a more complete expression that uses string slicing: 

PRINT OASIS TO 2) 


These two statements do exactly the same thing. Each of them prints the 
second character in thestring A$. A one-character sliceout of a string is just 
like an element of an array. Of course, you can also take slices of more than 
one character from strings, using a statement like the following: 


PRINT H$:z Ta Si 
There are no corresponding operations for numeric arrays, however. The 
following statement will give only a syntax error: 


PRIWT Bt та 51 


ni 


What we have here are really two notations for different situations. One is 
theslicing notation for parts of strings, and one is the array element notation 
for members of arrays. In just one case, the one-character slice, these two 
notations are identical. 

Although you don't have to dimension an ordinary string, you still must 
remember that it has a finite length. The length is determined when you 
definethestring with a LET or INPUT statement. You will get a syntax error if 
you try to use a string element that doesn't exist, like this: 


LET Dz$-'"AaABC"' 

PRINT D£:4j 
The effect is the same as if you had tried to reference a nonexistent element of 
a numeric array: 


ты 


Lil Fi 


f| Ui 


РЕТЫТ Fidi) 
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You can also have string arrays of more than one dimension. In fact, string 
arrays can have as many dimensions as you want, just as numeric arrays can, 
as long as your system has enough memory to contain them. To define a 
two-dimensional string array, for example, you would use a statement like 
the following: 


DIM H$i, У) 


This DIM statement creates an array of four strings, each of which is seven 
characters long. The last dimension of a string array always tells how many 
characters each individual string contains. This means that all of the strings 
in a string array must be the same length, although some of the characters 
may be blank spaces. 

You don't specify the last index, the length of the string, when you use an 
element of a string array. The computer will treat such an expression just 
like an ordinary string. For example, if you enter the following commands, 
the PRINT statement will print the five-character string APRIL: 


DIM GEIS. 
LET бїтї 2" APRIL” 
PRINT G£izi 


You can refer to individual characters in astring if you wish, by specifying 
the last index. After you enter the above statements, for example, the follow- 
ing command will print the letter R: 


PRINT Gia, 2! 


You can even use any of the forms of the slicing operations that you learned 
earlier, but only for the last index of the array. Either of the following two 
commands will print the substring PRI from the APRIL array just defined: 


PRINT БЕ. Е TO =: 


PRINT 65212 TO +: 


The next commands, which change the letters assigned to four characters, or 
elements in the array, will print CHILL: 

LET 6512,1 TO dis" CHIL" 

PRIHT G$::zi 


Just remember that you can only apply slicing to the last index of a string 
array, and that it works the same way there as it does for a single string. 


__________________________________ == === о—ђ---—_—_-_—_—_—__—«н 
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String arrays can be used to write a program that arranges a list of strings 
in alphabetical order. Thestrings themselves might bethe names of bowlers 
in a bowling tournament, names of cities, or any other kind of string. The 
following statements set up an array of ten strings, each a maximum of 12 
characters long, and let you enter the ten strings from the keyboard: 


DIM *$110,121 


= FOR Ісі TO 10 
із INPUT #01) 
12 NEXT I 


Recall that the symbols < and > for strings refer to alphabetical order. One 
string is “smaller” or “less” than another if it comes before it in alphabetical 
order. This means we can use the same technique for alphabetizing strings 
that we used for sorting numbers. All we have to do is modify our earlier 
sorting program to use string arrays instead of numeric arrays: 


1 DIM #%118,Ј2: 
5 FOR 1=1 TO 12 
а INPUT 2:71: 

= HEXT I 
5 
e 


гіз THEN GOTO 


за THEN GOTO 15 
i 


Enter the program, including lines 1-12. Then run it and enter any ten 
strings you like, as long as each of them is no longer than 12 characters. The 
program will print your 12 strings, rearranged in alphabetical order. 

Consider how hard it would be to do the same thing without arrays. You 
would need a different variable name for each string, and you would not be 
able to use loops. Even if you could write a program to alphabetize ten strings 
without using arrays, it would be much longer because it would have to deal 
with each pair of strings separately, by name. Worst of all, it would only work 
for exactly ten strings. The above program will work for any number of 
strings if you just change the 10 in lines 1, 5, and 50, and the 9 in line 20. 

Can you see how to write a more general program that would first accept 
the number of strings from the keyboard, and then accept that same number 
of strings and print them out in alphabetical order? 
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SUBROUTINES 


As the computer programs you write get longer, you will frequently find 
that you need to tell the computer to do the same thing at several different 
places in a program. For example, you might want to display different 
blinking messages at different times. You might want to test several differ- 
ent keyboard entries to make sure that each is a valid number. Or you might 
want to ealeulate compound interest for several different interest rates. 

One way to have the computer do the same task more than once in à 
program is to put the commands you want repeated inside a loop. However, in 
many situations that isn't good enough. You might want to display a blinking 
message or test an input at several different places that won't fit together in a 
single loop. 

Another solution is simply to duplicate the same code in different parts of 
the program: 


Start of program—» T 


— 


| | 525 Repeated routine 


For example, if you wanted to display two different flashing messages, you 
could do it like this: 


DHH 


за FOR E-1 TO LEN A$ 
SQ LET AIK} =CHR$ iC 


=! 
Ба PRINT HT 9,58% 
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РӨ LET ЁФІКІ =CHRS (CODE H$ik!- 
1281 

ай NEXT Қ 

SS КЕМ DISLHY SECOND LINE 

за LET Ar="PROGRARMMIMNE" 

104 PRINT AT 0,5:AS 

114 FOR E=1 TO LEN A$ 

120 LET НІК! SCHR (COCE ARIKI + 
128: 

120 РБІМТ HT а, =; АФ 

1428 LET ABIRi=CHRA (CODE nmn$iki- 
1231 


158 MEXT K 


Lines 30 through 80 are identical to lines 100 through 150. Although this 
approach works, it wastes valuable space in the computer. The more times 
you repeat the routine, the more wasteful it becomes. À well-written, useful 
computer routine is a valuable thing, and you ought to be able to use it 
whenever you want to, without all that trouble. 

A third way you might try to solve this problem is by putting in the 


repeated routine just once and inserting a GOTO statement each time you want 
to use it: 


10 
100 GOTO 2000 
110 
Subroutine 


+ 2000 | a Start 


250 GOTO 2000 
2150 | «—— End 


480 GOTO 2000 


RETURN 
where? 
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The problem with this method is that when you finish the routine, you need to 
go back to the next line after the coro that you used to get to the routine. Since 
there are several coros in the program, you need a command that acts like 
GOTO, but that also remembers where you were in the program when you 
executed it and goes back there when the repeated routine is finished. 

The BASIC language provides exactly this capability. The statement that 
acts like сото, but remembers where it came from, is called созов. The 
section of the program that you access in this way, from different parts of a 
program, is a subroutine. We say that the program calls the subroutine. This 
just means that the program uses GOSUB to branch to the subroutine. At the 
end of the subroutine is a RETURN statement, which tells the computer to go 
back to the next statement after the GosuB command that called the sub- 


routine: 
Main Program Subroutine 
2000 Start 
Remember 
110 
100 GOSUB 2000 
110 
Go to 
bered 
id 2150 RETURN End 


line ae 


The GosuB and RETURN statements allow you to re-use a part of your program 
as many times as necessary, from any place in the program. The RETURN 
statement will always send the computer back to the next line after the GosuB 
statement. 


The following program uses asubroutine to display two flashing messages: 


l0 ÉLUS 
12 REM DISPLAY FIRST LINE 
за LET Ags "COMPUTERS 
за SOSLIE 1408 
4Q REM DISPLAY SECOND LINE 
SÓ LET вљ= PRÜGEHHHING' 
сә SUB 10€ 
за 
ae NE STARTS H 
ERE 
ive 
iia 
128 ¿CODE ВФЕК: + 


ba 
Т. 
UG 


ee = оно о 
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ha 
fe a [I Pe 
meon cupa 
"а 


e 


When you run this program, the reverse video moves through the word 
COMPUTER once. Then the word PROGRAMMING takes its place and the 
reverse video moves through this word once. Then the program stops. 

The sroP command in line 70 is there to prevent the computer from 
running the subroutine a third time. Take itout and run the program again, 
and the word PROGRAMMING will flash across the screen twice. This 
happens because A$ is still equal to PROGRAMMING when the computer 
gets to line 100 for the third time. There is nothing special at the beginning of 
the subroutine to tell the computer, “A subroutine starts here." 

If you make the mistake of letting the computer go into a subroutine 
directly, instead of with a GOSUB statement, the computer doesn't know that 
you meant for that part of the program to be a subroutine. Then when it 
reaches the RETURN statement, it doesn't know where to go. This is why the 
program without line 70 gives error code 7, “No corresponding GOSUB for a 
RETURN statement." Make sure any subroutine you write can only be entered 
by using GOSUB. Sometimes you might be able to make a program a little 
shorter by letting the computer go into a subroutine directly from the pre- 
vious line or by jumping into the middle of a subroutine with GOTO, but such 
tricks make your program messy and difficult to follow. You will make fewer 
mistakes if you treat each subroutine as aseparate program unit and access it 
only with GOSUB. 

The main part of the program (lines 10 through 70) passes information to 
the subroutine by means of the variable A$. The subroutine can use any of the 
variables the main program uses. Thus, a subroutine may do something 
slightly different each time it is called, because the values of the variables it 
shares with the main program may have changed. In the above program, A$ 
is the only shared variable. If you wanted to have each word appear on a 
different line, for example, you could do it by making the line number in the 
PRINT AT command a shared variable also, like this: 


E 


ic LC 

15 REM Lg 
Бо LET i 
=: LET = 
Be GUI i 
42 FE La 
se LES "FER 
= ct _- 
=> Е: == 
ai AG 
5; 

THE SUBRITUTINE STARTS Н 
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PRINT HT LINE 2;8% 
FOR £=1 Tū LEN A$ 


LET НЕ =sCHRE (OCDE ABR I + 
FRINT AT LINE z;ns 

LET ARIKI SCHR CODE Agi: – 
HEXT K 

RETURN 


Be careful, though, not to use the same variable name in the subroutine and 
the main program unintentionally. Your program may do strange things if 
the subroutine changes the value of a variable when the main program does 
not “expect” that particular variable to change. 

It's perfectly all right for one subroutine to call another subroutine, for that 
subroutine to call still another, and so on. That's called nesting of subroutines. 
The computer still remembers where each one was called and goes back to 
the right place each time it executes RETURN. However, you should not try to 
have a subroutine call itself or call a subroutine that called it. Although 
careful, experienced programmers may sometimes do this in BASIC, the 
language is not really designed for it. 
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ow that you have learned the fundamental commands and func- 
tions of TS1000/ZX81 BASIC, you are ready to explore some 
special topics that go beyond fundamentals. Since these are ad- 
vanced functions, you will probably find some of them more useful than 
others, depending on the kinds of programs you write. 


OPTIMIZING PROGRAMS 


Ideally, a good computer program should (a) occupy as little space in the 
computer as possible, (b) execute quickly, and (c) be easy for other pro- 
grammers to read and understand. Unfortunately, in practice, an improve- 
ment in one of these qualities often detracts from the others. As a pro- 
grammer, you must find a suitable compromise among these three goals. 
Their relative importance may be different for different programs. For 
example, a game program using animated graphics must run fast enough to 
be fun for the players. On the other hand, if the program you are writing 
becomes too large to fit in the available memory, your top priority may be to 
redesign the program to use less space. 


Optimizing Clarity 


Make your program as clear and understandable as space and running 
time permit. The following suggestions will help you: 
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* Useremarks (REMstatements) liberally (but don't clutter your programs 
with unnecessary ones). Remarks should explain how the program works, 
not merely restate a program line in words. For example, 


REM DONT TRANSPOSE IF FAIR ALREA 
Dy; IM ORDER 


IF BidizeBilei)i TREN GOTO 45 
is much better than 
REM GO TO 45 IF Bii ІЗ SMALLER 


The second example does not tell you how the command fits into the 
design of the program. Remarks are especially important at the begin- 
nings of subroutines, explaining their purposes and listing all of the 
variables they share with other routines. 


* Choose variable names that describe the variable's function in the pro- 
gram. Names like LOCATION or LOC arelikely to be more helpful than 
names like X and B3. (Unfortunately, the names of arrays and strings 
cannot be more than one letter.) 


* Usesubroutines to organize your programs. Divide long or difficult tasks 
into simple, manageable parts, using a separate subroutine to do each 
part. Test each subroutine separately, and then incorporate the subrou- 
tines into the larger program. It is faster to write a short testing program 
for each subroutine than it is to test a larger program, because if the 
larger program fails to do what it should, it will be much harder to 
determine which part of the program contains the error. 


* Use GOTO sparingly. Too many coros branching in different directions 
can really complicate your programs. 


* Except for loops, avoid jumping backward in your programs. 


Optimizing Speed 


Techniques for making your programs run faster can conflict with the 
prineiples for writing readable programs. Therefore, use techniques like 
those that follow only when speed is important: 


* Never jump to а REM statement with GoTo or GOSUB; jump to the next 
statement instead. Place REM statements before or after loops, rather 
than inside them. If you need still more speed, delete all REM statements 
— each one takes time to execute. Keep a copy of the old program with the 
remarks in it for reference, however. 
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- Putsubroutines near the beginning of your program, not at the end. The 
computer will find them more quickly there because it starts looking for 
them at the beginning of the program each time it executes a GOSUB 
command. Use a single сото statement at the beginning of your program 
to jump over the subroutines and begin the main program. 


. Avoid unnecessary subroutines. If the program calls a subroutine from 
only one place, replace the GosuB command with its subroutine. 


. Perform as many calculations as possible before the beginnings of ani- 
mation or other time-critical parts of the program. If a program calcu- 
lates the same number several times, modify it to calculate the number 
only once and store it in a variable. If a loop contains a calculation that 
gives the same result each time, put the calculation before the beginning 
of the loop so that the computer will only have to do it once. 


- Whenever possible, replace several short strings in a PRINT statement 
with a single long string. Don't use a loop, for example, to print a string of 
repeated characters, like this: 


FOR Ісі ТЯ ze 

PRINT "me 

NEXT I 

Use a single quoted string instead, like this: 


ББІМТ "w————m—À '' 
- Insert the following command after each SCROLL command:? 
PRINT HT 2L. SL) AY 21,8: 


This will make a big difference if the next PRINT statement is long or the 
program has arrays with large dimensions. 


Optimizing Size 


The following suggestions will shorten your programs so that they use less 
memory. Some of them may make your programs less readable, however, so 
use them only if space is important. 


5Oliger, John, Syntax Z80 (The Harvard Group, Bolton Road, Harvard, Mass. 01451: April 1982). 


A __АЕЕо0 ССС 
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° Remove any REM statements. Each character in a REM statement occupies 
one byteof memory. Keep a copy of theold program with the remarks in 
it for reference. 


“ Eliminate repeated sections of code that are longer than two or three 
lines by making them into subroutines. Avoid short subroutines, how- 
ever, because GOSUB and RETURN also use memory space. 


° Use short variable names. Every character in a variable name uses one 

‚ byte of memory each time it appears in the program. If the program has 
severalsuccessive loops (not nested loops), use thesame name for the loop 
counter in all of them. Re-use other variable names whenever you can. 


· If the program uses the same constant more than once, use LET or INPUT to 
create a variable with that value and use it instead ofthe constant. Do this 
for both numeric and string constants. The reason for this is that in 
addition to the characters that you see on the display, each constant 
occupies five more undisplayed bytes every time it is used. 


* Shorten the prompts and other string constants. One way to do this is to 
use keywords (such as PRINT and STOP) in quoted strings, instead of typing 
out the words. The keywords will be printed just as if you typed them 
letter-by-letter. Each typed character uses one byte. 


* Clear the display screen often with CLs. 


* Avoid unnecessary parentheses in expressions. Take advantage of the 
priorities of numeric, string, and logical operators. For example, the 
expression 


means the same as the shorter expression 
LET я=-Е-5 


: If a program has many LET statements, enter them in command mode 
instead. The variables will keep their values when you SAVE and LOAD the 
program from a cassette, and you will save the memory that the LET 
statements occupied. (If you use this method, you must use GOTO instead 
of RUN when you start the program, to avoid erasing the variables.) 


STORING DATA ON CASSETTES 


Unlike many personal computers, the TS1000 and ZX81 do not provide a 
method of storing data files on cassette tapes. Theonly practical way to store 
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data is to put it into variables and save the program with the variables. If you 
know in advance what the data should be, you can enter it as an array, using 
an INPUT loop, the first time you run the program. After that, the data will 
remain in the program when you save and load the program from cassette. 
But you must remember not to execute CLEAR or RUN, because these com- 
mands erase all the program's variables. 

The following program illustrates cassette data storage. It reads ten num- 
bers from the keyboard into array B and prints them on thetelevision screen 


display. 

1 DIM 2:18) 

= FOR Ізі ТО m 
ја INPUT БҮТ! 

iz НЕХТ I 

са FOR £=1 TO ie 
Se PRINT Bik! 

та НЕЖТ F 


RUN the program and enter any ten numbers. Then delete lines 1-12. Use SAVE 
to record the program on cassette, and read it back with LOAD. Use GoTo 50 to 
start the program. Array B will still be there with the numbers you entered. 

Remember, though, that if you want to keep the numbers stored in B, you 
must always use GOTO 50 instead of RUN to start the program. In addition, you 
should write down the variable names and their dimensions in case you want 
to modify the program later. 


BAR AND LINE GRAPHS 


A graph can display data in a clear, direct way that is easier to comprehend 
than a table or a list of numbers. A program that draws a graph must first 
scalethe data. That is, it must determine how each data item will relate to the 
overall size of the graph on the television screen. For example, for a bar 
graph that will be 30 dots (pixels) wide, the program must multiply the 
numbers to be represented by a scaling factor that gives 30 for the largest 
number in the list. 

The following subroutine finds thelargest member of an array of numbers, 
scales it to 30 pixels, and draws a bar graph of the numbers in the array: 


јада REM Б ІЗ THE ARRAY OF HLMBEE 
R3 
10120 REM N TELLS AOL MANY NUMBER 
5 THERE ARE 

СРЦЕ THE NUMBERS 


1012 REM FIRST 


1828 
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1042 IF Е: 
Ti 

1050 NEST 
lesa LET 

12878 FEM 

јега FOR 


a 


Coe T GU 


5) 


Roi ba م‎ 
La be 

Ca p ҒАТ 
Fa rar ct 


To use this subroutine, you will also need to write a master program that 
reads in the numbers and calls the subroutine as follows: 


INFT М 

DIM Bini 

FOR 121 TO N 
INPUT EII 
NEST I 

созыв 1090 
3TOF 


J On en f c nà e 
Car rrr 


Enter the program and subroutine. To see how they work, enter 5 for N 
and 5, 10, 15, 20, 10 for theelements of B. The program willthen producethe 
following bar graph on the display: 


You ean improvethe bar graph routine by adding a title, labels along the left 
side, and a scale across the bottom. Your master program should print the 
title, since you may use the same subroutine for many different graphs. For 
the labels, you can add an array of N strings, each five characters long. The 
master program will definethese strings, and the subroutine will print them 
beside the corresponding bars. The subroutine will also print the scale. (If 
your system is the ZX81 without memory expansion, delete the REM state- 
ments to save memory space before making these changes.) The complete 
program is as follows: 


= PRINT "HILLIONS GF SALES РЕ 
YEAR” 

у INPUT H 

DIM Bihl 

DIM Leth, Si 

FOR І-і TO N 


I 


Qa PU a E ~ 
fau e rg 
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INPUT 25113 


40 INPUT BII? 
га НЕХТ I 
ва GOSUB 1000 
та STOP 
Boum REM 5 ІЗ THE ARRAY OF NUMEE 
cS 
108120 REM RM TELLS НОЈ HAY NUMBER 
3 THERE ARE 
1815 REM FIRST ЗОВЕ THE NUMBERS 
ега LET HAS SB (1: 
таза FOR [== TO H 
1040 IF Bil: :HA® THEN LET MAX=E/ 
I! 
іссе НЕХТ I 
јава LET SCALE =38-HA® 
лата БЕН FLOT THE NUMBERS 
заза FOR I-i TO N 
103S PRIHT HT 2341.0:;LB/15 
лаза FOR Мш1 TO B!I)s2CBHLE 
1108 PLOT +85 ,42-4 +1 
L113 НЕХТ dJ 
1120 HEXT I 
1130 PRINT AT 2+4+2,4: 
1448 FOR 121 To E 
1150 PRINT ", '; 
1152 NEXT I 
iieg PRINT РТ ВЫ, 4; Q';HT zxH 
43,123; HA» 
1170 RETURN 


Run this program using 5 for N again and enter the following array values: 


I L$(D 
1 1978 
2 1979 
3 1980 
4 1981 
5 1982 


The resulting display is 
мш тона OF SALES 


1975 — 


PER YEAR 
197.7 — 

1980 — 

1551 ——' ND 


1252 -— 


а EI 


в 
5 
10 
15 
20 
10 
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Bar graphs like the ones above are ideal for comparing a fairly small set of 
numbers. Line graphs, on the other hand, are usually better for displaying 
mathematical functions, or information whose general shape and trend is 
more important than the detailed values of the points. A line graph is like a 
bar graph, but only the last pixel of the bar is plotted. In addition, while bar 
graphs may be either horizontal or vertical, a line graph always has the 
function plotted vertically. 

The following program draws a graph of the sin function between zero and 
2*PI. Thesubroutinethat it calls will plot any set of points whose coordinates 
are given by the arrays X and Y. (For the ZX81 without the memory expan- 
sion unit, change the value of N from 63 to 9.) 


жюз IL 


1 
H mom dE md 


мын Eo 


JB 
= 


TE pe pe pei ш oe os 
Ea fur e» Cu un LUE 


Іле 


ker e e E Ra ei ке p не ех EOD ES КУ ы > 
бе Fa fa Fa fa E E Fac Fa Fa Fa fa Fa Ca fa б 


Eee 
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MORE ABOUT LOGICAL EXPRESSIONS 


Chapter 6 described the logical operators AND, OR, and NOT and explained 
how to use them with such comparisons as =,<, and >. These operations are 
related to each other in regular ways, and you can often simplify your 
programs and make them clearer by understanding these relationships. In 
addition, the TS1000 and ZX81 represent the results of such comparisons as 
ordinary numbers, which you ean use to construct more powerful commands 
for controlling the flow of your programs. 


Opposite and Equivalent Expressions 


Each of the six relational operators that your computer recognizes has one 
of the others as its opposite. Table 7-1 gives the opposite of each one. To put it 
another way, for each kind of test there is another test using the мот operator 
that means exactly the same thing. This is shown in Table 7-2. These relation- 
ships are really nothing more than common sense. For example, if A is 
smaller than B or equal to B, then obviously A cannot be larger than B. 

The logical operators AND and oR also combine in special ways with NOT. 
Consider the following expressions: 


IF HOT in-B OR С=61 
IF МОТ (A=B AND с=20) 


As Table 7-3 shows, each such expression has an equivalent form without 
parentheses. 
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Table 7-1. Opposite Pairs of Relational Operators 


Operator Meaning Opposite Operator 
= Equal <> 
< Less than >= 
> Greater than <= 
<= Less than or equal > 
>= Greater than or equal < 
<> Not equal = 


Table 7-2. Equivalent Tests Using NOT 


IF A=B IF NOT A<>B 
IF A<B IF NOT A>=B 
IF A>B IF NOT A<=B 
IF A<=B IF NOT АРВ 
IF A»—B IF NOT A<B 
IF A<>B IF NOT A=B 


Table 7-3. Equivalent Expressions 


Expression Equivalent Expression 
IF NOT (A=B OR С=р) IF NOT A=B AND NOT C-D 
IF NOT (A=B AND C=D) IF NOT A=B OR NOT C=D 


These expressions are examples of a general rule: If Nor comes before an 
expression in parentheses that uses OR or AND, you can remove the paren- 
theses if you change the operator inside the parentheses and repeat NOT for 
each part of the expression. 


Logical Operations on Numbers 


Chapters 4 and 6 described the three different kinds of expressions in the 
BASIC language (see Table 7-4 for a summary). 

When the computer evaluates an expression of any kind, itstores the result 
as a number. For strings, it uses a character code (Appendix C) to represent 
each symbol on the keyboard. The computer also uses numbers to store the 
result of logical expressions. 

You can use conditional tests without knowing how the computer translates 
the tests into numbers, just as you can use strings without knowing the 
character code. However, by learning about the numeric representations, you 
will be able to use them to write even better programs. 
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Table 7-4. Types of Expressions 


Type Example 
Numeric Expressions A+B 
String Expression A$+B$ 
Logical Expression A<BORC=D 


“TRUE OR FALSE” TESTS 


To demonstrate how the computer stores the results of comparisons, enter 
the following commands: 


Command What the Computer Prints 
PRINT 1:2 1 
PRINT 2:1 e 
PRINT 727 1 
PRINT Уі e 


If the condition is true, the computer uses one to represent the result of the 
test. If the condition is false, the computer uses zero. Thus, a command like 


LET ARSUER=10:<:15 


may look strange to us, but the computer understands it perfectly. Since the 
expression 10<>15 is true, the computer gives the variable ANSWER a 
value of one. 

The logical operators AND, OR, and хот ordinarily apply to expressions like 
10«» 15. Recall that an expression using AND is true if both conditions are 
true. For example, the expression (10«» 15 AND 5-5) is true. The expression 
(10<> 15 AND 5-6), however, is false because five is not equal to six. As you can 
see, the computer represents the results of these longer expressions by num- 


bers as well: 
Command What the Computer Prints 
PRINT {1105515 AND бшш! 1 
PRINT (10::15 AND баб) а 
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Table 7-5. AND Operation Truth Table 


The AND operation gives 1 (true) only if both values are 1. 


1 AND 1 gives 1 1 AND 0 gives 0 
0 AND 1 gives 0 0 AND 0 gives 0 


Table 7-6. OR Operation Truth Table 


The OR operation gives 1 (true) only if either value is 1. 


lORIgivesl 1 OR 0 gives 1 
0 OR 1 gives 1 0 OR 0 gives 0 


Table 7-7. NOT Operation Truth Table 


The NOT operation gives the opposite of each value. 


NOT 1 gives 0 
NOT 0 gives 1 


Just as before, the computer uses one to represent a true expression and zero 
to represent a false expression. Table 7-5 shows what happens with the AND 
operator for all four possible combinations of true and false expressions. 

Table 7-5 is called atruth table. It tells everything there is to know about the 
AND operator. Table 7-6 is the truth table for the or operator. 

The last operator is мот. Its truth table is the simplest because it operates on 
only one expression (Table 7-7). 

Enter the following commands and verify that they give the answers 
specified by the truth tables: 

PRINT 1 AND 1 

PRINT 15=5 AND &iz?i 

PRINT © AND 1 

PRINT (18:28 AND Sac) 

PRINT Ә OF 1 

PRINT (2-10800 OR 2:42 

ВЕШТ а OF 1 

PRINT il8:z-1 OR i8:z-z? 

РБІМТ NOT i 

PRINT NOT а 

PRINT WOT E=5 
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Since one and zero represent true and false, you might expect a syntax 
error when you use some other number with AND, OR, or NOT. Instead, the 
computer accepts any numbers with these operators. It does this by treating 
any number other than zero as true. The following examples show how it 
evaluates such expressions: 


Command What the Computer Prints 
PRINT 10 AND 28 ја 
РЕШТ а AND 50 a 
PRINT 10 ANC BG e 
PRINT а AND а а 


If either of the numbers is zero (false), the overall expression will be false. 
(That's what AND means.) If neither is zero, the expression is true. Note that 
when the result is true, the left number of the pair is used to represent that 
truth. 

You can use any number or numeric expression with the OR operator, as 
well. The following example illustrates how or works: 


Command What the Computer Prints 
PRINT Да Ок 50 i 
PRIHMT а OF 3a + 
PRINT 10 OR B ig 
PRIHT а OR 2 е 


The first three results count as “true,” and the last опе as "false." If the 
number on the right of oR is not zero, the value of the overall expression is one. 
If the number on the right is zero, then the value of the overall expression is 
equal to the number on the left. 

The Nor operator simply gives one (true) if its argument is zero (false) and 
zero (false) if its argument is one (true): 


Command What the Computer Prints 
PRINT NOT а i 
PRINT NOT 1 e 
PRINT NOT 17 e 
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BRANCHING 


The following expression will be equal to A, B, or C depending on whether I 
is equal to 1, 2, or 3: 


(A AND Tali¢tB AWD Ісгі-іс AND I 
231 


ш.2: 


(The expression will be equal to zero if I has a value different from any of 
these.) 

Many programs display a menu of options and ask the user to select one of 
them by entering a special code (such as the first letter of the name of the 
desired option). Such a program needs to branch to a different line or call a 
different subroutine, depending on the option selected. The following pro- 
gram shows how to use AND to implement a menu selection: 


i8 PRINT "SELECT ONE OF THE FO 
LLOUWING:'" 


га PRINT " M - START A МЕЧ 
GAME" 

за PRINT O" R - RESUME THE P 
REUIOUS GAME" 

48 PRINT " T - PRINT THE TO 
TRL SCORE TO DATE" 

SO PRINT ^" F - FORGET ABOUT 


PLL PREVIOUS GAMES" 
Ей INPUT AS 


та сото (1008 AND ABLIO= UN + га 
FE ANC AG (LI = ЕІ + (2282 AND Н%(11 
H"T"14¢(18@8 AND A$i1i =" FU) 


This program will branch to statement 100 if you type N, to 476 if you type R, to 
802 if you type T, and to 1000 if you type к. Of course, you could accomplish the 
same result with four conditional statements instead of line 70, as follows: 


Fe IF Ailis“ THEN GOTO 1009 
ТЕ TF H$:i)j-"Ep" TREN БОТО 476 
74 IF H$il)'z"T" THER SOTO Баг 
75 IF Aili =F’ THEN SOTO 1000 


The second method is more straightforward, but it occupies more memory 
and runs more slowly than the method using AND. 

As arule, AND works best with addition, and or works best with multipli- 
cation. For example, a department store having a sale might program its 
computers to use a different discount rate for purchases from different 
departments. The following commands illustrate one way of writing such a 
program: 
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200 REM D DEPARTMENT 
2310 IF Of ЕЗ” THEN LET 
PRICESPRI 

ове IF EC$ THERN КЕТ E 
EICEZFRICE 

zc IF DË THEN LET FR 
ICE=FRICE+ 


The following program using the special properties of the oR operator, how- 
ever, will do the same thing more quickly and occupy less memory: 


drm T ra 
DUREE 


If D$ is equal to one of the quoted strings, the <> relation will be false, and the 
oRexpression will be equal to the corresponding discount rate. Whenever D$ 
is not equal to the quoted string, the true «» relation will produce a value of 
one, leaving the price unchanged. 


Logical Operations on Strings 


152 


The TS1000 and ZX81 permit only one kind of logical operation on strings. 
The operator must be AND and the string must be on the left side. The 
computer evaluates such a logical expression just as it would evaluate the 
same logical operation on a number: 


Command What the Computer Prints 
PRIMT “TEST AND ze TEE 
PRINT “TEST AND € 


The number on the right of AND can also be any relational expression. You can 


use logical operations on strings to make commands like the following short- 
er and faster: 


112 THEM SRINT “GOOR 


An equivalent command using a logical expression is 


"HORA ING AN 
47 ANDE TIME 
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Priority in Expressions of Mixed Type 


Recall that each operation in BASIC has a priority. When the computer 
evaluates an expression, it does the highest priority operations first, then the 
ones of next highest priority, and so on. Parentheses override this priority 
system, forcing the computer to evaluate the part of the expression between 
the parentheses first. 

Priority rules also apply to the two kinds of mixed-type expressions that 
the TS1000 and ZX81 permit: logical operations on numbers and logical 
operations on strings. Table 7-8 gives the priority of every kind of operation. 
Refer to it whenever you need to know which operations the computer will 
evaluate first. Use parentheses whenever you want the computer to follow a 
different order. 

If an expression contains morethan one operation of the same priority, the 
computer evaluates them from left to right. 


INSIDE BASIC 


The purpose of BASIC is to make the computer easy to use. Without BASIC 
(or alanguage like it) you would have to learn many complicated details about 
the inner workings of the computer to make it do what you want. BASIC 
allows you to use familiar English words like LET, PRINT, and NOT, familiar 
symbols like =, +, and –, and convenient variable names to write programs 
easily and quickly. You don't need to know any more about how the computer 
works, or about how BASIC does what it does, in order to write good BASIC 
programs. However, if you do learn more about these subjects, you will be 


Table 7-8. Priority Table 


Symbol Operation Priority 
0 Subscripting and slicing 12 
ABS, CHRY, etc. Functions (except NOT and unary minus) 11 
.. Exponentiation 10 
= Unary minus 9 
*/ Multiplication and division 8 
+, = Addition and subtraction 6 
=, <, >, <=, >=, <> Relational operators 5 
NOT NOT 4 
AND AND 3 
OR OR 2 


SOURCE: Timex User Manual by Steven Vickers, © 1982 by Timex Corporation 
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able to use more of the features of the TS1000 or ZX81. The remainder of this 
chapter describes some of the advanced features of BASIC and how to use 
them in your programs. 


The Organization of Memory 


The fundamental unit of memory in most personal computers, including 
the TS1000 and ZX81, is the byte. A byte can contain any number between 0 
and 255. A floating point number (like the numeric constants and variables 
of BASIC) occupies five bytes. The thousands of bytes that make up the 
computer's memory are numbered consecutively, beginning with byte num- 
ber 0. These numbers are the addresses of the bytes. To find out what number 
is stored in a byte, or to store a different number in a byte, you must know the 
byte's address. 

The TS1000 and ZX81 computers contain two kinds of memory: read-only 
memory (ROM) and read/write memory (RAM). The read-only memory is 
located between addresses 0 and 8191. The numbers in read-only memory are 
permanent. You eannot change them, and they remain the same even if you 
unplug and reconnect the power cord. Read-only memory contains the mas- 
ter program that controls the computer and carries out all the commands of 
BASIC. It also contains other permanent information, such as the list of 
character codes and the shape of each kind of character for the television 
display and printer. 

Read/write memory begins at address 16384. (The TS1000 and ZX81 do not 
use the addresses between 8192 and 16383 at all.) Read/write memory con- 
tains your program, your variables and their values, and the television 
display image. BASIC also uses part of the read/write memory for storing 
variables of its own (the system variables), for doing calculations, and for 
keeping track of nested GosuB calls, among other things. The blocks of 
addresses used for various functions are shown in Figure 7-1. 

You can read from and write to the contents of read/write memory, but 
when you disconnect power, everything you stored disappears. 


PEEK and POKE 


The PEEK function (on the 0 key) takes an address as its argument and gives 
the contents of that address (the number stored in that byte) as its value. For 
example, to determine the contents of the first ten bytes of read-only memory, 
run the following program: 
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Address 


Protected Space 
RAMTOP 
Work Space for 


Master Program 
Stack Pointer 


Available 
Memory 


Read/Write 
STKEND Memory (RAM) 


Work Space for 
E LINE Master Program 


Variables for 
BASIC Program 
VARS 


Display File 
BASIC Program 
16509 
16384 


Read-Only 


Figure 7-1. The organization of memory 


The program prints the following numbers: 
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Adapted from Timer User Manual by Steven Vickers, © 1982, Timex Corportation. 


42 


== 
== 


The TS1000 and 2Х 81 do not have any memory between locations 8192 and 
16383. You can still PEEK these addresses, but the computer will subtract 8192 
from any address you give it in this range. For example, the computer will 
print the same numbers as before if you replace line 10 above with the 
following: 


10 FOR я=5192 TO 320i 


The POKE command changes the contents of a byte in read/write memory 
(RAM). To use it, press POKE (on the O key), followed by the address of the byte 
you want to change, a comma, and the number that you want to store at that 
address. The following program illustrates POKE. Be sure to include the REM 
statement exactly as follows: 


i REM zx 
12 FORE 15514.20 
Run the program and then press ENTER again to see the program listing. The 
first line of the program has changed to 


1 REM - 


When you enter a program, BASIC stores the characters that you typein a 
section of RAM memory beginning at address 16509 (Figure 7-1). Address 
16514 is the byte that contains the first character after REM in line 1 of this 
program. By POKEing a different character code into this address, you 
changed the program itself. Look in Appendix C and verify that 20 is the 
character code of the = symbol. Change the number 20 in line 10to a different 
character code, run the program again, and watch the corresponding char- 
acter from Appendix C appear in the program listing. 

POKE is a powerful command and should be used carefully. Although you 
cannot actually damage the computer by using POKE, you can change any part 
of your program or the system variables (locations 16384 to 16508) that 
BASIC uses for its own internal purposes. If you do accidentally POKE the 
wrong address, you can makethe computer stop functioning. For example, if 
you enter the following command the computer will produce an unusual 
television display: 


POKE 16384,49 


The result is different for systems with different amounts of read/write 
memory. If your system includes the memory expansion unit, you may want 
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to try this command both with and without the unit. (Remember to unplug 
power before changing the memory expansion.) Once you have entered this 
POKE command, you cannot continue without unplugging and reconnecting 
power. 

You cannot POKE read-only memory (addresses 0 to 8191). The computer 
does not report an error if you try to POKE these locations, but the POKE 
command will not change the contents of the byte. 


The System Variables 


Appendix B lists all of the system variables and their functions. A typical 
entry in Appendix B looks like this: 


ERR. МЕ 16384 1 less than the report code 


The first column gives the name of the variable. This particular variable's 
name is ERR. NR. These names, however, are not BASIC variable names — 
in fact, the underscore character (__) that appears in some of them is illegal 
in BASIC. These variable names thus provide a convenient way of referring 
to the system variables in system program listings, but the computer does not 
recognize them. The only way of accessing the system variables is to PEEK or 
POKE their addresses. 

The second column in the list gives the address of the variable in read/ 
write memory. Most of the system variables occupy either one or two bytes. 

Use ERR. NR if you want your BASIC program to produce error reports 
at the lower left corner of the screen for special errors. For example, the 
following command produces an error report G/O at the lower left corner of 
the screen: 


PORE 16384,15 


If you use this command within a program (that is, if you give it a line 
number), it will also stop the program at that point. If you POKE a number 
between 0 and 14, you will produce one of the standard system error codes (1 
through 9 and A through F). If you POKE a number between 15 and 34, you 
will produce one of the letters G through Z. If you POKE a number between 99 
and 127, you will produce a graphics symbol or a reverse-video character in 
the first position of the error report. If you POKE any higher numbers into this 
address, your program will stop and you will have to pull the plug to restart. 


The Highest Memory Location 


The system variable RAMTOP, at addresses 16388 and 16389, keeps track 
of how much read/write memory the system has. Like many of the system 
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variables, it is larger than 255. Since 255 is the largest number a single byte 
ean contain, RAMTOP requires two bytes. To find the value of such two-byte 
variables, multiply the contents of the second byte by 256 and add it to the 
first byte. For example, to find the value of RAMTOP, enter the following 
command: 


PRINT PEER 163685425 


ch 
+ 
71 
m 
m 
H 
Ti 
Cl 
а) 
[Ти] 


The result depends оп how much read/write memory your system has, 
because RAMTOP is the variable that BASIC uses to remember how much 
memory it has available. The TS1000 has 2048 bytes (2K) of read/write 
memory. Since read/write memory always begins at address 16384, the above 
command will print 18432 (which is 16384-- 2048) on a TS1000 without the 
memory expansion unit. For a ZX81 with 1024 bytes of read/write memory 
(1K), the command will print 17408. It will print 32768 on either computer 
with the 16K memory expansion pack attached. The highest available mem- 
ory location is actually one less than RAMTOP. 

By POKEing a new value into RAMTOP, you can make BASIC act as if it 
had more or less read/write memory than it actually has. For example, you 
might want BASIC to ignore a section of read/write memory in order to 
reserve those addresses for a machine language subroutine (see Chapter 8) or 
for some other purpose. To change a two-byte variable like RAMTOP, you 
have to separate it into two numbers between 0 and 255. The following 
program shows how to change RAMTOP to 16610: 


10 LET TüOPz16518 

тїт POKE 15353, INT {ТОР 2561 

за ЕСКЕ i16385,TOP-zZosPEEK i53 
за 


4@ NEU 


Line 20 divides TOP by 256 and discards the remainder to get the more 
significant byte of the number TOP. Line 30 calculates the part of TOP that is 
left over (the less significant byte). In two-byte system variables, the less 
significant byte always comes first in memory, so the program POKES the less 
significant byte into memory address 16388 and the more significant byte 
into location 16389. Follow this procedure whenever you need to change a 
two-byte system variable. 

The NEW command in line 40 is not part of the general procedure for other 
system variables. It is necessary when you change RAMTOP, in order to 
force BASIC to rearrange its memory organization to fit the new RAMTOP. 

When you run the above program, the program disappears and the 8 
cursor appears at the bottom, just as it always does when you execute NEW. 


158 The Zx81/TS1000 Home Computer Book 


But now BASIC thinks it has only a few bytes of RAM for storing programs 
and displaying information. The effect is obvious as soon as you begin to enter 
a new program. Enter the following line: 


10 REM 12345 


When you type 5, the line moves from the bottom to the top of the screen. 
BASIC reduces the size of the display to make room in read/write memory 
for the program line. Type more characters, and the display line will actually 
get shorter as the computer shrinks the display file to make room for the 
program. 

Unplug and reconnect power to restore BASIC to its normal condition. 


The Program Storage Area 


BASIC stores your program in read/write memory beginning at address 
16509. It stores each program line as shown in Figure 7-2. 

The first two bytes give the line number, and the third and fourth bytes 
give the number of bytes in the line. The number of bytes is stored with the 
less significant byte first, just like the system variables, but the line number 
has the more significant byte first. 

A BASIC program can use PEEK to examine the program storage area, and 
it can use POKE to change what is there. Such a program is actually rewriting 
itself while it runs. Be very careful if you try to write such programs, because 
any errors or inconsistencies that you produce in the program storage area 
will probably make BASIC malfunction, and you will have to pull the plug. 

The following program shows how to examine the program storage area 
and extract information from it. It does not change any of the bytes stored 
there, but it uses PEEK to determine what its own line numbers are. Then it 
prints a list of the line numbers on the television display. 


CALCULATE РЕШЕ, WHITH 


REM END OF THE PROGRAM STOR 
E 


OF THE LINE 
17 REM THE FIRST LINE ALWAYS = 
TARTS HT 12509 
Ес LET РЕУТЕ =16 589 


27 РЕМ CALCULATE (МИН, WHICH I 
= THE 

ЕЗ РЕМ LINE HUMBER OF THIS FRO 
GRAM LINE 

за LET LHLIMZzPEER (FBYrTE+11 4256 


+РЕЕК РВУТЕ 
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da PRINT LNLH 


45 РЕМ CALCULATE THE FIRST ADD 
RESS OF THE НЕХТ LINE 

са LET FEYTE-FBEYTE«FEER ІҒЕУТЕ 
42) +256 РЕЕК {РЕТТЕ +52: +4 

== РЕН Боде BACK TODO NEST LI 
HE 

СЕ REM UNLESS END OF PROGRAM d 
AS BEEN REACHED 

ва IF FEYTE:SDFILE TREN GOTI за 


Line 10 calculates the system variable D__FILE, which marks the end of 
the program listing in read/write memory (Appendix E). Line 20 initializes 
the variable FBYTE, the address of the first byte of the next program line. 
Line 30 uses FBYTE to determine the line number, which is stored with the 
most significant byte first (see Figure 7-2). Then line 50 uses the next two 
bytes to calculate the length of the line and adds this length to FBYTE. It also 
adds four for the four bytes at the beginning. These store the line number and 
length. The new value of FBYTE is the address of the first byte of the next 
line in the program. Line 60 compares FBYTE to D. FILE to determine 
whether there are any more program lines. If so, it branches back to do the 
next one. Run the program and observe that it prints the correct list of 
statement numbers. 

A program that just prints out a list of line numbers is not very useful. 
However, now that you understand how to examine the program area, you 
can also write programs that change what is there. The following program 
asks for a first line number and an increment between line numbers, and 


More Significant Byte 
Less Significant Byte 
Less Significant Byte 


More Significant Byte 


Length of 
Text 


Adapted from Timex User Manual by Steven 


Vickers, 9 1982, Timex Corporation. 


Figure 7-2. A BASIC program line in memory 
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then renumbers the program lines so that the line numbers are equally 
spaced: 


азай REM RENUMEER PROGRAM 

S985 PRINT "FIRST LINE NUMBER" 
9910 INPUT СНОМ 

39920 PRINT "INCREMENT? 

3930 INPUT INC 

2940 LET ЕБУТЕ =15 59 

3950 IF (PEER iFBYTE*1!)!-4255xPEEK 
FEYTE) >=990@ THEN STOP 

9960 POKE РВУТЕ, INT (Ним 256) 

3970 FORE FRYTE+1,LNUM-S564PEER 

РЕТТЕ 

9950 LET LNUM=LNUM+ INC 

9990 LET FRYTE=FBYTE+PEERK (FRYTE 
+21 +2 56 +НЕЕК (FBYTE+3)} +4 

9995 GOTO 9950 


This program will renumber all program lines below 9900. It must not try to 
renumber its own lines because that would confuse BASIC while the renum- 
bering was going on. Line 9950 makes sure the number of the line it is about 
to change is smaller than 9900 and stops if it is not. 

To demonstrate the RENUMBER program, enter it together with another 
program for it to renumber. You can use the compound interest program 
shown earlier in this book. When you have entered both programs, the 
complete listing should look like this: 


= PRINT “HOW MANY GUARTERS?" 
5 INPUT NGUARTS 
ла LET WORTH=108 
га LET РЯТЕ=@, 1а 
за LET QRATE=RATE ^4 
40 FOR Ісі TO NOUARTS 
ва LET INTEREST -üRHRHTEsUORTH 
Та LET WORTH=WORTHS+ INTEREST 
= WEST I 
а PRINT WORTH 
ча STOP 
зада PRINT "FIRST LINE HUMBERT” 
3918 INPUT мим 
9920 PRINT "IHCREEMEHT?' 
заза INPUT INC 
9240 LET FEYTE=185089 
9954 IF (PEEK (FEYTE+11 +250*PEEF 
FRYTE! > =39@0 THEN STOP 
39080 PORE ҒБҮТЕ,ІМТ {Чин 2551 
9970 PORE FEYTE+1,LHUM-255+PEER 
ЕБҮТЕ 
3958 LET LHUH=LHUH+ INC 
эм LET FRYTE=FEYTE+FEER (FRYTE 
I +2 560 +РЕЕЕ (FRYTE+S3i +4 
395 БОТО асса 


[ТЕ + UL IL 
i mu Ше) 
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LU 


Line 90 separates the two programs and prevents the computer from going 
on to the second one after it finishes the first. Now enter GOTO 9900 to start 
the RENUMBER program. Enter 100 for the first line number and 20 for 
the inerement. When the program has finished running, press ENTER again 
to see the program listing. It should look like this, with the compound interest 
program neatly renumbered: 


SURRTERS?" 


192 
тас 
Lea 


a ra c‏ ل 


fa f 


1 Ti TIFT 


Use the RENUMBER program whenever a program you are writing has 
its line numbers too closely spaced, preventing you from inserting more lines 
where you want them. It will save you the trouble of editing all the program 
lines to change their numbers. If your program is long, the time you save in 
editing will be worth the extra time it takes to type in the RENUMBER 
program. 

Be careful, though. RENUMBER does not change GOTO or GOSUB state- 
ments, so you must still use the editor to make them correspond to the new 


m line numbers. 


The Display File 


Directly above the program storage area in read/write memory is the 
display file (Figure 7-1). Thesystem variable D_ FILE contains the address 
of the first byte of the display file, and the system variable VARS gives the 
starting address of the next region of read/write memory, the program 
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variables area. The display file is simply a list of all the characters on the 
screen, in order, one character per byte. For the end of each lineon thescreen, 
the display file includes a byte containing 118, the character code for ENTER. 
The computer uses the information in the display file to produce the display 
and to produce a copy of the screen on the printer when you execute the COPY 
command. 

You can change the display by poKEing character codes into the display 
file, but you must be eareful not to change one of the ENTER bytes. To work 
correctly, the computer requires exactly the right number of ENTER bytes in 
the display file. 

On systems including the 16K memory expansion unit, each blank line on 
the screen has a full line of blanks in the display file. On systems without the 
memory expansion, each blank line is represented by a single ENTER byte in 
the file. 

The following program uses PRINT AT to make sure the display file contains 
a full line of blanks for the top line on the screen. Then it calculates D_ FILE 
using PEEK, and POKES the codes for the letters of the alphabet into the display 
file bytes for this line, over and over. 


ARMA A A 


A са 
ri 


(CH mun em TET 
л! 


pam и лин 


pen 


TTF 
гп 


Ti 


LA 
Tal Di Ca Ca 
H 


POON ra Es 6 rp me 
Cam n me 


CTO f a а 


піл 


Run the program and watch the letters move across the line. To stop the 
program, press BREAK. 

The system variable DF__CC contains the address (in the display file) of 
the print position, which is thelocation wherethe PRINT command will print 
the next character. You can change the print position by POKEing a new value 
into DF... CC, as long as the number you choose corresponds to a real charac- 
ter position on the screen, not an ENTER byte. BASIC programs do not 
ordinarily need to change DF... CC in this way or to POKE numbers into the 
display file, however, because they can accomplish the same thing with 
PRINT AT. 
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he most fundamental language of any computer is its machine lan- 

guage. This is the language that the central processor of the computer 

understands and obeys. When the computer executes a program in 
BASIC (or any other language), it must first translate the commands into 
machine language. 

The translating program for BASIC is part of the master program in 
read-only memory (ROM), and it does its job automatically. When you run a 
BASIC program, you don't have to think about machine language at all. 
However, a machine language program can use some of the features of the 
computer that BASIC programs cannot use, and machine language pro- 
grams run much faster than BASIC programs. For this reason, BASIC 
includes a function called usR that calls machine language subroutines. 

This book will not attempt to teach you how to write machine language 
programs. That topic really requires a whole book by itself. (Appendix N lists 
several good books on the subject.) This chapter explains how you can usethe 
machine language routines that appear in published programs without hav- 
ing to learn machine language itself. It includes several machine language 
subroutines as examples, and Appendix G gives several more. Don't be 
concerned if you don't understand the details of these routines. Most personal 
computer users never bother to learn machine language. You can still use the 
machine language subroutines that other people write, just by following a 
few simple instructions. 
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ENTERING MACHINE LANGUAGE SUBROUTINES 


Machine language is very different from a high-level language like BASIC. 
Each machine language instruction is just a number stored in a byte of 
read/write memory. The machine language programmer uses a small por- 
tion of memory to store a machine language subroutine. A BASIC program 
that calls the machine language subroutine must do two things. First, it must 
store the machine language instructions in the correct addresses of read/ 
write memory (usually by means of the POKE command). Second, it must 
execute the UsR function to call the subroutine. 

The argument of the usn function is the address in memory where the 
subroutine begins. The machinelanguage programmer determines the value 
of the usn function for each machine language subroutine. In some cases, the 
main purpose of the machine language subroutine is to calculate a value for 
USR. In other cases the value of UsR is irrelevant. 

A machine language subroutine must occupy a part of memory where it 
cannot interfere with the activities of the master program. Machine lan- 
guage programmers usually store their routines in one of two places: in a 
REM statement at the very beginning of the BASIC program or in protected 
space above RAMTOP. 


Machine Language In a REM Statement 


Like any other BASIC statement, a REM statement occupies one byte of 
read/write memory for each character. BASIC doesn't care what the charac- 
ters in a REM statement are. It ignores them and goes on to the next line. A 
REM statement usually contains text that reminds the programmer how the 
program works, but a machinelanguage programmer can put the bytes of a 
machine language subroutine into it instead. There the subroutine cannot 
interfere with the master program, and the sAVE and LOAD commands pre- 
serve it on cassette along with the BASIC program. 

The following program stores a machine language subroutine in a REM 
statement: * 


1 ВЕН YER. мот STAR MANDA TAB 
RLANDTAN 

= FOR X-16514 TO заса 

3 INPUT I 

4 FORE X.I 

S NEXT X 


The REM statement must be the first statement in the program, in order to 
make certain that its text begins at address 16514. In this example, the REM 


6 Miller, Harold. Syntar 280 (The Harvard Group, Bolton Road, Harvard, Mass. 01451: August 1982). 
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statement has 16 characters because this particular machine language 
subroutine will have 16 bytes. It doesn't really matter what characters you 
type when you first enter the REM statement, as long as you type at least 16 of 
them. The example program uses digits because they are easy to count. The 
rest of the program is a loop that reads the 16 bytes from the keyboard and 
POKES them into the REM statement. Run it and enter the following numbers: ' 


Lal E 
un 


тою e خم زل شم‎ 
P та wu 
ch f£ 


ке (f‏ فم 
ل لا 
ff‏ 


па gi 


C P 


ps 


These numbers constitute a machine language subroutine. Don't try to under- 
stand what they mean. As a BASIC programmer, you can use other people's 
machine language subroutines without learning the details of machine 
language. 

Press ENTER again after the last number to see the program listing. If you 
typed all the numbers correctly, the screen should look like this: * 


B 


OF ta mbr 


The REM statement now contains the machine language subroutine. The 
master program, however, still displays it on the television screen as if it 


7 Miller, Harold. Syntax 280. 


8 Miller, Harold. Syntax 280. 
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contained text. For example, the first byte you entered was 62, and Y is 
character 62. Therefore, the first character in the REM statement is Y. 
Machine language subroutines in REM statements always produce a strange- 
looking display line. 

With the machine language subroutine safely stored in the REM statement, 
delete lines 2-5. To call the subroutine, enter the command 


RANCE ISR 1 


m 


514 


The usr function is on the L key. Its argument is 16514 because that is the 
address of the REM statement in read/write memory. Some machine lan- 
guage subroutines return a useful value for the usr function. This one does 
not. Nevertheless, USR is still a function, so you must use it in a command 
where a function is legal. 

Either of the following commands would also call the routine: 


The PRINT command is most suitable when the machine language subroutine 
returns a value for usR that you want to display on the screen. The LET 
command is best when you need to save the value for future use. Finally, RAND 
is best when you don't care what the value is, because RAND doesn't alter the 
display and it doesn't waste space for an unnecessary variable. 

When you execute any of the commands that call the machine language 
subroutine, the subroutine darkens the display by printing a black square 
(GRAPHICS SPACE) in every character position. Now the screen looks like this: 


Miller, Harold. Syntax Z80. 
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In FAST mode, the machine language subroutine runs much faster than the 
following BASIC program, which produces the same result: 


H 

от 

пс 

1] 

“1-4 
Т 


1 Тп 7284 


u 


Published programs with machine language subroutines in REM state- 
ments often include an input loop like the one in lines 2-5 above. Regardless of 
what the machine language subroutine does, the procedure for storing itina 
REM statement is usually the same. However, don't try to use a REM statement 
if the instructions tell you to put the machine language somewhere else in 
memory. Most machine language routines must be in exactly the right 
memory addresses in order to work properly. 

Some published programs tell you to enter the bytes of the machine lan- 
guage subroutine directly as you type the REM statement. All the characters 
in the above REM statement appear on the keyboard, so you could type in the 
REM statement exactly as it appears instead of using an INPUT loop. To try it, 
execute NEW and enter the following characters, being carefult to turn the 
cursor on and off (with sHIFT-9) at the right places:? 


Symbol How to Make It 


1 a number 
REM a keyword 
Y a letter 
B GRAPHICS SPACE 
a GRAPHICS SHIFT-T 
a GRAPHICS SHIFT-4 
: SHIFT-Z 
a GRAPHICS K 
NOT FUNCTION N 
$ SHIFT-U 
TAB FUNCTION P 
E GRAPHICS SHIFT-H 
RND FUNCTION T 
B GRAPHICS SHIFT-5 
TAB FUNCTION P 
"n GRAPHICS SHIFT-Y 


RND FUNCTION T 
TAN FUNCTION E 


The display should now contain a REM statement exactly like the previous 
one. Check it very carefully before you call the subroutine. If you make a 


? Miller, Harold. Syntax Z80. 
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mistake in a machine language subroutine, you may have to unplug the 
power to the computer in order to get the Я cursor again. 
Call the subroutine with the same command as before: 


RAND DSR 15214 


It will produce the same darkened screen. To fill the screen with some other 
character when thesubroutine is called, edit the REM statement to replace the 
second character (GRAPHICS SPACE) with the new screen-filling character. 

Some machine language subroutines are difficult or even impossible to 
type directly. If the REM statement contains a BASIC command word (such as 
LET or PRINT), you must enter the command word first on the line, then space 
backward (SHIFT-5) to enter REM. Also, since there are fewer than 256 key- 
board symbols, some byte values do not represent any character (see Appen- 
dix C). Such a byte appears as a question mark (?) on the display, but you 
cannot enter it by typing a question mark or any other character. To enter one 
of these codes into a REM statement, you must use a POKE command, To avoid 
such problems, use an INPUT loop instead of typing the machine language 
directly. 


Machine Language Above RAMTOP 


A REMstatement disappears when you load another program from cassette 
or when you execute NEW, but a machine language subroutine above RAM- 
TOP remains. This is an advantage if several different BASIC programs call 
the machine language subroutine. The method has disadvantages as well, 
however: SAVE and LOAD don't preserve or restore the protected space on 
cassette; the address of the protected space is different for systems with 
different amounts of read/write memory; and a few extra commands are 
required to reserve the space in the first place. Published programs using 
this method will either reserve the space themselves or tell you what com- 
mands to give to reserve it. They will usually also include a loader routine 
that POKEs the machine language into the reserved space at the beginning. 

The following program reserves space above RAMTOP for a machine 
language subroutine: 
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153335, ,RAMTOP-ISBEFPEER 


Run the program and enter 14 to reserve 14 bytes. The program will disap- 
pear from the screen, and the reserved bytes will be ready. To use them, enter 
the following program: 


12 SAMTOR=PEER ie&28S8-4256sF 
ЕЕЕ 1 5 

іш = ©, RAMTOF 

га КАНТОР +15 

+0 


This program is similar to the INPUT loop in the previous section, but it POKES 
the program into the space above RAMTOP. Run it and enter the following 
numbers: 1° 


(Te pe ET 
RB mí 
ІН 


y Ff 
ЕТІ 


UN 


ІЛ һы 


Fu 


{л m м gp T C) pe Dm EB EB RR 
+ га 
Му 


~ 
= 


Now enter the command RAND USR RAMTOP to call the machine lan- 
guage subroutine, which fills the screen with reverse-video plus signs (+). 
Delete the entire BASIC program by typing each line number, so that 
nothing but the 3 cursor remains. Execute RAND USR КАМТОР; the 
same pattern of reverse-video plus signs appears on the screen. The machine 
language is safe even if you LOAD another program or execute CLEAR ог NEW. 


10Foley, Robert A. Syntax ZX80 (The Harvard Group, Bolton Road, Harvard, Mass. 01461: September 1982). 
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You must remember the new value of RAMTOP, however, in order to call the 
subroutine after executing one of these commands. 


MACHINE LANGUAGE LOADERS 


The above programs with INPUT loops are examples of loader programs. 
They load machine language into a REM statement or into addresses above 
RAMTOP using POKE. If you have studied machine language programming, 
or if you want to enter longer machine language programs written by others, 
you will need more complete loader programs that make it easy to edit, save, 
and load machine language. Appendix F describes several more powerful 
loader programs and explains how to enter and use them. Appendix J gives 
some longer machine language routines that are both useful and fun. 


FOR MACHINE LANGUAGE PROGRAMMERS ONLY 


If you already know the Z80 machine language of the TS1000 and ZX8I, 
the information in this section will help you adapt your knowledge to the 
special features of these computers. 


* Use the RET instruction (decimal value 201) to return to BASIC. The 
BREAK key does not work for machine language routines. 


° The value of the usn function is the value that the machine language 
subroutine leaves in the BC register pair when it returns to BASIC. 


° The master program uses the ГУ register to store the starting address of 
the system variables. 


· A machine language subroutine may use the stack, but it should restore 
it to its original state before returning to BASIC. 


- If you change the contents of the IY, I, or HL’ registers, you must save 
them first and restore them afterward. 


° Machine language subroutines run in either SLow or FAST mode, which- 
ever was active when the BASIC program called usr. 


° In этом mode, you must not change the A’, F’, IX, IY, or R registers, even 
if you restore them later. The master program uses them for the display 
while your machine language subroutine is running. 
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- Appendix L tells how to use several of the subroutines in read-only 
memory (ROM). 


- Appendix N lists sources of further information on TS1000 and ZX81 
machine language programming. 
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eyes | A m <5 | | 
FE dee = 


This appendix describes all of the commands and functions of BASIC for 
the TS1000 and ZX81 computers. First it lists the commands and then the 
functions, each list in alphabetical order. Use this appendix for reference 
when you need to look up how to use a particular command or function or 
when you want to scan through the list for one that does what you want to do. 


IMMEDIATE AND PROGRAMMED MODES 


All BASIC commands and functions, except the INPUT command, can be 
used in either immediate mode (also called command mode) or in programmed 
mode. In other words, you can either execute the command without a line 
number and have the computer carry out the command immediately, or 
includethe command in a program for later execution by numbering theline. 


FORMAT CONVENTIONS 


The following symbols and abbreviations will be used in the command and 
function summaries to describe BASIC syntax: 


(] Braces indicate a choice of items within the state- 
ment. The braces are not part of the command; the 
computer keyboard does not even have braces on it. 
You must choose one of the items between the braces 
and include it with the command to make a useful 
BASIC statement. 


= 
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Line numbers 


Other 
punctuation 


UPPERCASE 


italics 


Brackets enclose optional items. The command is 
legal with or without the items in brackets; your 
purpose in using the command determines whether 
to include these items or not. The brackets them- 
selves are not part of the command. 


Three dots indicate omitted information or that an 
optional item may be repeated in the command. 


Every program line has a line number. Immediate 
mode commands do not. The summary does not 
specify line numbers, but they are implied if you 
use the item in programmed mode. 


All other punctuation marks—commas, semicolons, 
quotation marks, and parentheses—must appear 
exactly as shown. 


Uppercase words and letters must appear exactly 
as shown. 


Items in italics are names of general categories 
that appear in commands and functions. You must 
substitute a real variable name, constant, or ex- 
pression for each italicized item. Use the defini- 
tions below and the descriptions of the individual 
commands and functions to decide exactly what to 
put in the place of such italicized items. 


DEFINITIONS OF ITALICIZED TERMS 


A typical BASIC command may include string or numeric constants or 
expressions. Some may use array names or FOR-NEXT loop counters, which 
have special restrictions. This section describes the different categories of 
acceptable names and specifies an abbreviation (in italics) for each one. After 
you look up a particular command or function in the alphabetized list, refer 
to this section for the meaning of the italicized abbreviations that you found 


there. 


bytexpr 


col 


A numeric expression whose value is between 0 
and 255. 


Column number on the display screen or the print- 
er. A numeric constant, variable, or expression 
should be between 0 and 31 in a PRINT or LPRINT 
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STATEMENTS 


This section describes all of the TS1000/ZX81 BASIC statements. Each 
command is a single symbol on one key; don't try to type in a command letter 
by letter. The descriptions give the command's purpose, its keyboard loca- 
tion, the general format of the statement in which it is used, and one or more 
examples of its use. 


BREAK 


expr 


letter 


line 


numexpr 


row 


statement 
strexpr 


var 


statement and between 0 and 63 in a PLOT or UNPLOT 
statement. 


Any valid expression or combination of expressions. 
Includes any combination of constants, variables, 
or expressions, and may be numeric, string, rela- 
tional, or logical. 


A single letter (A to Z). 


Linenumber on the display screen or the printer. A 
numeric constant, variable, or expression in a 
PRINT ог LPRINTstatement, with a value between 0 
and 21. 


Any numeric constant, variable, function, or valid 
combination of these items. 


Row number on the display screen ог the printer. А 
numeric constant, variable, or expression in a 
PLOT or UNPLOT statement, with a value between 
0 and 43. 


Any valid BASIC statement. 


Any string constant, variable, function, or any valid 
combination of these items. 


Any numeric or string variable name, including 
array elements. 


Purpose: halts program execution and returns the computer to immediate 


SPACE Key 


BREAK 
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CLEAR 


CLS 


Example: BREAK 


Press BREAK while a program is running to terminate the program as soon 
as the computer finishes the line it is currently executing. This command will 
interrupt any BASIC line except one with INPUT or USR. It will even interrupt 
a cassette SAVE or LOAD operation. To terminate INPUT of a numeric variable, 
enter STOP (SHIFT-A) or any letter that is not the name of a defined variable. To 
terminate INPUT of a string variable, delete the quotation marks and enter 
STOP (SHIFT-A). 

When a BREAK occurs, the computer finishes the current program line and 
switches to immediate mode. It displays the report code D, followed by the 
number of the line that was executing. You can continue program execution 
with the CONT command (on the с key). Execution will continue with the next 
line after the one you interrupted. 


Purpose: deletes all variables currently defined. 


Location: x Key 
Format: CLEAR 
Example: CLEAR 


The cLEAR command erases the computer's memory of any variables 
defined by previous LET or INPUT statements. This inereases the amount of 
free memory available. The computer's condition after you press CLEAR is the 
same as it was immediately after you entered the program but before you 
ran it. 


Purpose: clears the display screen and frees the memory space the dis- 
played information occupied. 


Location: v Key 
Format: CLS 
Example: CLS 


The display is erased without affecting the stored program or the vari- 
ables. When a program stops with error report 4 (not enough room in 
memory), or when EDIT fails for lack of memory to display the edit line, cLs 
makes more memory available. 
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CONT 


COPY 


DIM 


Purpose: resumes program execution after an error, STOP, or BREAK. 


Location: c Key 
Format: CONT 
Example: CONT 


The coNT command attempts to continue after the program terminates 
with a report code other than 0. Most program errors are not recoverable; that 
is, the same error will occur every time the computer tries to execute the 
command. Hence, coNT will not work with such errors. It will succeed after 
BREAK (report code D), stop (report code 9), and screen full (report code 5). It 
will also succeed after “undefined variable” (report code 2) if you first define 
the variable with a LET command in immediate mode. If you accidentally 
enter a letter instead of a number for a numeric INPUT command, coNT will 
give you a second chance. 


Purpose: makes a copy of the display screen on the printer. 


Location: 7 Key 
Format: COPY 
Example: COPY 


The computer ignores this command if the system does not include a 
printer. 


Purpose: creates all the members of the array and gives them the value 0 
(numeric arrays) or blank (string arrays). 


Location: D Key 
Format: DIM letter[$Knumexpr[,numerpr...]) 
Examples: DIM G(12) 

DIM Q(4,5,12) 

DIM C$(10,2) 


The DIM statement must come before any other statements that use the 
array. Each array requires a separate DIM statement. The TS1000 and ZX81 
allow as many numbers in parentheses as you want to use, provided the 


ooo m ee oor” 
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FAST 


FOR 


system contains enough read-write memory to hold the array. The name of an 
array must be asingle letter (for numeric arrays) or a single letter followed 
by a dollar sign (for string arrays). 


Purpose: puts the computer into fast mode. 


Location: SHIFT-F 
Format: FAST 
Example: FAST 


In fast mode, the display goes blank while a program is running, except 
during a PAUSE or an INPUT command. Programs run faster in this mode 
because the computer devotes all of its time to the program. Fast mode is also 
better than slow mode for typihg and editing program lines because the 
Screen responds more quickly to what you type. 


Purpose: starts a loop that repeats the lines between FOR and NEXT until 
the loop counter variable reaches a certain value. 


Location: F Key 
Format: FOR letter = startexpr TO endexpr [STEP stepexpr] 
Example: FOR I=1 To 10 


FOR A=TOP ro BOTTOM STEP —1 
FOR D=15 To 19.95 STEP .05 


The terms startexpr, enderpr, and stepexpr all represent numeric expres- 
sions. Letter is the control variable (also called the counter). When the com- 
puter first executes the FOR statement, it gives letter the value startexpr. Then 
it executes the statements following FOR until it reaches a NEXT statement 
with the same control variable name letter. It adds steperpr to letter (or it adds 
one if STEP is not present). It then compares the result to endexpr. If the value 
of letter has not yet reached endexpr, the computer branches back to the 
statement just after FOR. If the value of letter has reached or passed endexpr, 
the computer proceeds to the statement after NEXT. If stepexpr is positive, 
endexpr should be larger than startexpr. If steperpr is negative, enderpr 
should be smaller than starterpr. If not, then letter is already past endexpr 
before the loop begins, and the computer will skip the loop entirely. 
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GOSUB 


GOIO 


IF-THEN 


Purpose: calls a subroutine. 


Location: 
Format: 
Example: 


H Key 

GOSUB numezpr 

GOSUB 120 

GOSUB 2*SPACE+STA RT 


The computer rounds numexpr to the nearest integer and branches to that 
line number (or to the next higher line number if that one does not exist). 
Program execution continues from there until it reaches a RETURN state- 
ment. The program branches back to the statement immediately following 
the GOSUB statement. Do not use GOTO instead of RETURN to terminate a 


subroutine. 


Purpose: branches to the specified line of the program. 


Location: 
Format: 
Example: 


G Key 

GOTO numexpr 
GOTO 50 

сото A+LINE 


The computer rounds numexpr to the nearest integer and branches to that 
line number (or to the next highest line number if that one does not exist). 
Program execution continues normally from that line. 


Purpose: executes the associated statement only if the condition is true. 


Location: 
Format: 
Example: 


U and SHIFT-3 

IF expr THEN statement 

IF NUM1>NUM2 THEN PRINT "ILLEGAL DATA" 
IF B$—-^Y ES" AND X100 THEN GOTO 20 

IF 2+ VAL THEN RETURN 


If expr specifies a true condition, the computer executes the statement that 
follows the keyword THEN on the same program line. If expr specifies a false 
condition, the computer proceeds directly to the next program line without 
executing the statement. 


_________________________________ пољ O KK 
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INPUT 


LET 


LIST 


Purpose: accepts astring or numeric constant, variable, function, or other 
expression from the keyboard; evaluates it, and assigns the value to a 
variable. 


Location: I Key 

Format: INPUT var 

Examples: INPUT ANS 
INPUT D$ 


The INPUT statement displays the screen contents with a cursor and reads 
the value of a variable from the keyboard. To read values for several vari- 
ables, use several INPUT statements or a loop. The computer interprets the 
entry as a string or a numeric entry, depending on whether var is a string 
variable (with $) or a numeric variable (without $). 


Purpose: assigns a value to a specified variable. 


Location: L Key 
Format: LET var—expr 
Examples: LET X—24 
LET V$=“REPORT” 
LET A(5)=15*B+SIN .4 
LET STATUS-D 
LET CHOICE=PRICE<LIMIT 


The computer creates a variable named var if one did not already exist, 
evaluates expr, and gives the value to var. The variable can be a simple 
numeric ог string variable, a numeric or string array element, ог a string or 
string array element with substring slicing notation. A string variable 
requires a string expression, and a numeric variable requires a numeric, 
relational, or logical expression. 


Purpose: displays all or part of the program on the television screen. 


Location: K Key 
Format: LIST [numexpr] 
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LLIST 


LOAD 


LPRINT 


Example: 


LIST 
LIST 400 
LIST 60*BLINE 


The LIST command displays the program on the television screen, begin- 
ning with line numexpr or with the first line if numexpr is absent, and makes 
line numexpr the current line for the EDIT cursor. 


Purpose: displays all or part of the program on the printer. 


Location: 
Format: 
Examples: 


SHIFT-G 
LLIST (питехрт | 


LLIST 
LLIST 400 
LLIST 60*BLINE 


This command lists the program on the printer, beginning with line 
numexpr or with the first line if numerpr is absent. 


Purpose: transfers a previously recorded BASIC program from eassette 
to the computer memory. 


Location: 
Format: 
Examples: 


J Key 
LOAD strexpr 


LOAD “OLDPROGRAM” 
LOAD W$+“JUNE” 
LOAD “” 


Purpose: prints characters on the printer. 


Location: 
Format: 
Examples: 


SHIFT-S 


LPRINT [expr] [{;1..[ехр”]|... 

LPRINT “TIMEX-SINCLAIR PRINTER” 
LPRINT SQR 12, A $ 

LPRINT “THE ANSWER IS”;NUM5 
LPRINT TAB 7; A*B;ar 12,1;CHR$ 40 


ہہ 
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The LPRINT command prints numbers and strings on the printer. Items 
allowed in an LPRINT command are constants, variables, functions, more 
complicated numeric and string expressions, semicolons, commas, TAB, 


and AT. 
NEW 
Purpose: deletes the current program and its variables from memory. 
Location: A Key 
Format: NEW 
Examples: NEW 
NEXT 
Purpose: marks the end of the loop started by a previous FOR statement. 
Location: N Key 
Format: NEXT letter 
Example: NEXTK 
PAUSE 
Purpose: suspends program execution for a specified time, or until you 
press a key. The television screen remains active during the pause, even in 
fast mode. 
Location: M Key 
Format: PAUSE numexpr 
Examples: PAUSE 120 
PAUSE 60*NSEC 
PLOT 


Purpose: darkens the picture element (pixel) at the specified row and 
column, and moves the print position to just after that location. 


Location: Q Key 

Format: PLOT col, row 

Examples: PLOT 20,5 
PLOT 3*1+-2,J 
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A pixel is asmall square, one-fourth the size of a character on the display. 
The PLOT command treats the screen as a grid of pixel positions, 64 pixels 
wide and 44 pixels high. Col must be between 0 and 63, and row must be 
between 0 and 43. After PLOT, the print position is the next character after the 
pixel. 


POKE 
Purpose: stores a byte of data in a specified memory location. 
Location: 0 Key 
Format: POKE numerpr, bytexpr 
Examples: POKE 16388,221 
The value of numexpr must be between 0 and 65535 and bytexpr must be 
between —255 and 255. 
PRINT 
Purpose: displays characters on the television display. 
Location: P Key 
Format: PRINT [ezpr][(:...[expr |]... 
Examples: PRINT"TIMEX-SINCLAIR PRINTER" 
PRINT SQR 19,А% 
PRINT “THE ANSWER IS"; NUMS5 
PRINT TAB 7;A*B; AT 12 2 CH R$ 40 
REM 
Purpose: allows you to place explanatory comments (remarks) in a 
program. 
Location: E Key 
Format: REM [comment] 


Example: REM SHOW MENU OF OPTIONS ON SCREEN 


The comment is any sequence of characters, although ENTER (character 
code 118) has a strange effect on the display. The REM statements appear in 
programs listed using LIST or LLIST, and they are preserved by SAVE and LOAD. 
Otherwise, BASIC ignores them. They also occupy space in memory and 
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RETURN 


RAND 


RUN 


SAVE 


make a program run slightly more slowly. Machine language programmers 
may POKE bytes of machine code into a REM statement to keep the code from 
interfering with BASIC and to have it saved and restored with the program 
on cassette. 


Purpose: branches to the statement immediately following the most 
recently executed GOSUB statement. 


Location: y Key 
Format: RETURN 
Example: RETURN 


A RETURN is placed at the end of asubroutine to branch back and continue 
execution at the place in the program that is called the subroutine. A RETURN 
without a previous GOSUB produces error report code 7. 


Purpose: selects the sequence of numbers that the RND function will 
produce on subsequent calls. 


Location: T Key 
Format: RAND [numerpr | 
Examples: RAND 

RAND 476 


Purpose: erases any existing program variables and starts the program 


that is in memory. 


Location: R Key 
Format: RUN [numerpr | 
Examples: RUN 

RUN 150 


Purpose: sends a copy of the program currently in memory, together with 
its variables, to a cassette. 
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Location: s Key 


Format: SAVE strexpr 
Examples: SAVE "OLDPROGRAM" 
SAVE S$+“JUNE” 
SCROLL 
Purpose: moves the display up one line, making room at the bottom of the 
screen for a new line. 
Location: B Key 
Format: SCROLL 
Example: SCROLL 
SLOW 
Purpose: puts the computer into slow mode. 
Location: SHIFT-D 
Format: SLOW 
Example: SLOW 
Slow mode is also called compute-and-display mode. In this mode, the 
computer maintains the display while the program is running. It is called 
slow mode because the computer spends much of its time controlling the 
display, making the program run more slowly. 
STOP 
Purpose: halts program execution and returns the computer to immediate 
mode. 
Location: SHIFT-A 
Format: STOP 
Example: STOP 
UNPLOT 


Purpose: erases the picture element (pixel) at the specified row and 
column and moves the print position to just after that location. 
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Location: w Key 
Format: UNPLOT col,row 
Examples: UNPLOT 

UNPLOT 3*I--2,J 


A pixel is a square one-fourth the size of a character on the display. The 
PLOT and UNPLOT commands treat the screen as a grid of pixel positions, 64 
pixels wide and 44 pixels high. col must be between 0 and 63, and row must be 
between 0 and 43. 


FUNCTIONS 


This section describes the TS1000 and ZX81 BASIC functions. The func- 
tion symbols are printed below the white key squares. To select a function, 
first press SHIFT-ENTER, giving you the Ш cursor. Then press the key for the 
function you want. 

Most of the functions take one argument, but a few take no argument. The 
argument of a function —the expression on which it operates — goes to the 
rightofthe function name. Parentheses around the argument areoptional if 
the argument is a single constant or variable. The value of a function —the 
information it returns to the program — is astring if the function name ends 
with a dollar sign; otherwise, its value is a number. 

The descriptions below give the keyboard location of each function, its 
general format, and oneor more examples of its use. Refer to the beginning of 
this chapter for an explanation of the terms and abbreviations in the 
descriptions. 


ABS 
Purpose: returns the absolute value (magnitude) of the number that is the 
argument. The result of this function is always a positive number, regardless 
of the argument's original sign. 
Location: G Key 
Format: ABS (питехрт) 
Example: IF A—ABS A THEN PRINT "POSITIVE" 
ACS (ARCCOS) 


Purpose: returns the arccosine of a number. 


Location: s Key 


Appendix A: Summary of All BASIC Commands and Functions 189 


Format: ACS (numerpr) 
Examples: LET ANGLE-Acs.5 


The value of Acsis in radians. Numexpr must be between —1 and 1. It is the 


cosine of the value. 


ASN or ARCSIN 


Purpose: returns the arcsine of a number. 
Location: A Key 
Format: ASN (питехрт) 


Example: LET ANGLE=asn (1/3) 


The value of ASN is in radians. Numexpr must be between —1 and 1. It is the 


sine of the value. 


ATN (ARCTAN) 


CHR$ 


CODE 


Purpose: returns the arctangent of a number. 
Location: D Key 

Format: АТК (питехрт) 

Example: PRINT ATN X 


The value of ATN is in radians. Numexpr is the tangent of the value. 


Purpose: returns the string value of the specified character code. 


Location: U Key 
Format: CHR? (byterpr) 
Example: PRINT CHR$ 40 


Bytexpr must be between 0 and 255. 


Purpose: returns the character code number for a specified character. 


Location: I Key 
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Format: CODE (strexpr) 
Example: IF CODE A$<28 THEN PRINT "NOT A NUMBER" 


If the string is longer than one character, CODE returns the character code 
for the first character in the string. If strerpr is the empty string, CODE 
returns 0. 


COS 
Purpose: returns the cosine of an angle. 
Location: w Key 
Format: COS (numexpr) 
Example: PRINT COS Y 
Numezxpr is an angle, expressed in radians. 
EXP 
Purpose: returns e raised to a power. 
Location: x Key 
Format: EXP (numexpr) 
Example: LET À—EXP 2.4 
This function computes e (the base of natural logarithms, 2.7182818) raised 
to the power numezpr. 
INKEY 
Purpose: reads the key currently pressed on the keyboard. 
Location: B Key 
Format: INKEY$ 
Example: LET R$—INKEY$ 


This function returns the character for the key currently pressed, or the 
empty string if no key is pressed or if several are pressed. It is useful in 
controlling program operation while the program is running. 


eee 
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INT 


LEN 


LN 


PEEK 


Purpose: returns the integer portion of a number. 


Location: R Key 
Format: INT (numexpr) 
Example: IF C< >INTC THEN PRINT “NOT AN INTEGER” 


This function returns the largest integer less than or equal to the value of 


numerpr. 


Purpose: returns the length of a string. 


Location: K Key 
Format: LEN (strexpr) 
Example: IF LEN S$5 THEN STOP 


Purpose: returns the natural logarithm of a number. 


Location: z Key 
Format: LN (питетрт) 
Example: LET A=B*Ln C 


Computes the natural (base e) logarithm of numexpr. An error occurs if 
питехрт is zero or negative. 


Purpose: returns the contents of a memory location. 


Location: o Key 
Format: PEEK (numexpr) 
Example: PRINT PEEK 16388 


The PEEK function returns the number stored in memory location 
numexpr. An error results if nwmexpr is less than zero or greater than 65535. 


S m mmm 


492 The ZX81/TS1000 Home Computer Book 


Purpose: returns the constant 3.1415927. 


Location: M Key 
Format: PI 
Example: LET CIRCUM-rI*«DIAM 


RND 
Purpose: returns a random number between 0 and 1. 
Location: T Key 
Format: RND 
Example: PRINT 5*RND 
Therandom number is greater than or equal to zero and less than one. The 
RAND command selects the sequence of numbers for RND. 
SGN 
Purpose: identifies a number as positive, negative, or zero. 
Location: F Key 
Format: SGN (питехрт) 
Example: IF SGN A = —1 THEN PRINT “NEGATIVE” 
The sen function returns 1 if numexpr is positive, —1 if it is negative, and 0 
if it is zero. 
SIN 


Purpose: returns the sine of an angle. 


Location: Q Key 
Format: SIN (numexpr) 
Example: PRINT SIN X 


Numexpr is an angle, expressed in radians. 


1 A AA AAA A A ———— ————MQÀ MM 
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STR$ 


USR 


Purpose: returns the square root of a positive number. 


Location: H Key 
Format: SQR (numexpr) 
Example: LETHYPOT-sqR (LEG1+**2+LEG2**2) 


This function computes thesquare root of numezpr. Using a negative value 


for numexpr causes an error. 


Purpose: converts a numeric value to a string. 


Location: Y Key 
Format: STR$ (питехрт) 
Example: LET A$=sTRÍ (2/3) 


This function converts the value of питехрт to a string. The characters in 


the string are the same as those that PRINT numexpr would display on the 
screen. An error occurs if numexpr exceeds the limits for numeric values. 


Purpose: returns the tangent of an angle. 


Location: E Key 
Format: TAN (питехрт) 
Example: PRINT TAN .2 


Митехрт is an angle, expressed in radians. 


Purpose: branches to a machine language program. 


Location: L Key 
Format: USR (numexpr) 
Example: PRINT USR 16514 
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When the TS1000 or ZX81 finishes executing a program, whether in 
command or program mode, it displays a pair of numbers or a letter and a 
number, separated by a slash, in the lower left corner of the screen. If the 
computer is in programmed mode, the second number will bethe number of 
the last line executed. If the computer is in command mode, the second 
number will be zero. The first number is the report code. It indicates why the 
computer stopped at that line. 

The following descriptions of the different report codes will help you 
diagnose and fix problems in your programs. 


REPORT CODE O: 
SUCCESSFUL COMPLETION 


The computer did not detect any errors. Either it executed the last line of 
the program, or it executed a GoTo ог aGosuB with a line number larger than 
the last line of the program. 


REPORT CODE 4: 
UNDEFINED CONTROL VARIABLE 


The second number in the report is the line number of a NEXT statement 
whose control variable (the variableto the right of the NExT keyword) has not 
previously appeared in a FOR command. Such án error usually produces 
report code 2 instead of 1, but code 1 occurs when the program contains a 
variable with the same name as the control variable, but which is not part of 
the FOR statement. 

The FOR and NEXT statements must always occur in pairs. Every FOR 
statement marks the beginning of a loop and specifies a control variable (the 
variable name immediately after the FOR keyword). The corresponding NEXT 
statement specifies the same control variable and marks the end of the loop. 
You may have mistyped the name of the control variable in the FOR command 
or the NEXT command, or you may have branched into the middle of a loop 
with a GOTO or GOSUB command. 


„__— ——————————-——-—-— 
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REPORT CODE 2: 
UNDEFINED VARIABLE 


Report code 2 may occur in three situations. First, you must use a LET, 
INPUT, or FOR statement to give a variable a value before you attempt to use the 
variable, and the computer must execute this statement before it can use the 
variable in any other statement. For example, the following program will 
produce report code 2/30, because the GoTo statement caused the computer to 
skip giving a value to A: 

1а сото за 

га LET Ass 

за LET E=2%A 

Second, report code 2 can mean that you forgot to include a DIM statement 
before using an array. Every array requires a DIM statement to tell the 
computer its name and size. The DIM statement also defines the array's initial 
variables by assigning the value zero to all its elements. 

Third, if the line number in the report is the number of a NEXT statement, 
report code 2 means that the control variable (the variable to the right of the 
NEXT keyword) was not specified in a FOR command (see report code 1). 


REPORT CODE 3: 
SUBSCRIPT OUT OF RANGE 


A reference to an array element produces report code 3 if the subscript is 
larger than the corresponding Dm statement allows. For example, the follow- 
ing program produces the report 3/20: 


128 CIH Bil! 
20 LET 2:1]):=2,4 


A subscript smaller than 1 or larger than 65535 will generate a report code 
B instead of 3. 


REPORT CODE 4: 
NOT ENOUGH ROOM IN MEMORY 


This report means that the computer has used all of the available read/ 
write memory (RAM) and cannot finish executing the program line. Even 
the report code itself may be incomplete because the computer did not have 
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enough memory to display it. Any one of several BASIC commands can 
produce this error. It means that your program or its variables use more 
memory than you have available. Chapter 7 suggests some methods of con- 
serving memory. 


REPORT CODE 5: 
NO MORE ROOM ON THE SCREEN 


Your program has tried to write more lines (with PRINT, PLOT, UNPLOT, or 
LIST), but the screen is full. The TS1000 and ZX81 do not automatically scroll 
the display upward to make more room at the bottom. To clear thescreen and 
continue printing, execute CONT in command mode. 

To avoid this problem entirely, use cLs at places where the screen may be 
filled, or use SCROLL before each PRINT statement to move the display up one 
line. 


REPORT CODE 6: 
ARITHMETIC OVERFLOW 


The program line tried to create a number that is beyond the range the 
computer can handle. Many different kinds of calculations can produce this 
error. The most common one is division by zero, as in the following example, 
which produces report 6/20: 


ја LET =й 
ЕО LET seve 


The rules of mathematics forbid division by zero. 

In some cases not involving division by zero, you can redesign the program 
to use smaller numbers. Arrange the numeric expression so that those 
operations that make the result smaller occur first. For example, the line 


ја LET *“=100+12837 1000 


produces error report code 6 because the computer tries to multiply 100 by 
ЈЕ 37. The intermediate result is 1E39, which is too large. To avoid the error, 
write the command as follows: 


ја LET хад» (lear 1000) 


First the computer divides by 1000 to give 1Е 34. Then it multiplies by 100 to 
give 1E36. АП of these numbers are smaller than 1E38, so no error results. 


NN eee 
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If you think none of the calculations in the reported line should produce 
such alarge number, insert PRINT statements before the line to display all the 
variables it uses. The real cause of the problem could be an error earlier in 
the program that gave one of the variables a very large or very small value. 


REPORT CODE 7: 
NO CORRESPONDING GOSUB 
FOR A RETURN STATEMENT 


The computer encountered a RETURN statement without first executing a 
GOSUB, or it encountered another RETURN statement after returning from all 
the previous GOSUBS. 


REPORT CODE 8: 
INPUT IN COMMAND MODE 


The INPUT statement can be used only in programmed mode. It must have а 
line number. To givea variable a value in command mode, use LET instead of 
INPUT. 


REPORT CODE 9: 
STOP STATEMENT EXECUTED 


Report code 9 is a normal program termination, not an error. It indicates 
that the computer executed a sToP statement on the reported line number. 


REPORT CODE A: 
INVALID ARGUMENT TO CERTAIN FUNCTIONS 


Report code A means your program violated one of the rules for a mathe- 
matical function. For example, the argument of the зав function cannot be 
negative; the argument of LN must be greater than zero; and the argument of 
ACS or ASN must be between —1 and 1. 
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REPORT CODE B: 
INTEGER OUT OF RANGE 


The computer will generate report code B when an integer is larger or 
smaller than its allowable range in the computer. 

Several commands and functions round their arguments to the nearest 
integer and require the integer to be within a certain range. Among these, 
RUN, GOTO, GOSUB, LIST, LLIST, PAUSE, RAND, DIM, PEEK, and USR give error 4 if 
the integer is larger than 65535 or negative. The POKE command requires its 
first number to be in this range also, and its second number to be between 
—255 and 255. The PLoT and UNPLOT commands allow column numbers only 
from 0 to 63 and line numbers from 0 to 43. Line numbers used with PRINT AT 
must be between 0 and 21, and column numbers must be between 0 and 31. 
Specifications for PRINT TAB and arguments of CHR3 must be between 0 and 
255. 


REPORT CODE C: 
INVALID ARGUMENT FOR VAL FUNCTION 


Thestring argument of VAL must be a valid numeric expression. That is, it 
must be an expression that you could use in a LET statement to define a 


variable. 
REPORT CODE D: 
BREAK 
Report code D is a valid termination, not an error. It appears when you 
interrupt a program with BREAK at the keyboard or when you enter STOP in 
response to an INPUT statement. 
REPORT CODE F: 


SAVE REQUIRES A NAME FOR THE PROGRAM 


The empty string “ " cannot follow save. Put at least one character between 
the quotation marks to identify the saved program on cassette. 
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OTHER REPORT CODES 


Report codes E, G-Z, graphies symbols, and reverse-video symbols are 
available to BASIC and machine language programmers, but the master 
program does not use them for errors it detects. If oneof them occurs, look for 
its meaning in the documentation for the program you were running. 


ss ta 
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Each keyboard symbol has its own numeric code, which represents the 
symbol used in BASIC strings, in the BASIC program listing, in variable 
names, and in the display file. Table C-1 is a complete list of these character 
codes. 


Table C-1. Character codes 


Decimal Hexadecimal 
Code Character Code 
0 space 00 
1 Е 01 
2 (3 02 
3 m 03 
4 а) 04 
5 || 05 
6 w 06 
7 Ғ 07 
8 Е 08 
9 led 09 
10 ial 0A 
11 " 0B 
12 0C 
13 $ 0D 
14 : 0E 
15 ? OF 
16 ( 10 
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Table C-1. (Continued) 


Decimal Hexadecimal 
Code Character Code 
17 ) 11 
18 » 12 
19 < 13 
20 = 14 
21 + 15 
22 — 16 
23 * 17 
24 / 18 
25 ; 19 
26 , 1A 
27 А 1B 
28 0 1C 
29 1 1D 
30 2 1E 
31 3 1F 
32 4 20 
33 5 21 
34 6 22 
35 7 23 
36 8 24 
37 9 25 
38 A 26 
39 B 27 
40 C 28 
41 D 29 
42 E 2A 
43 F 2B 
44 G 2C 
45 H 2D 
46 I 2E 
47 J 2F 
48 K 30 
49 L 31 
50 M 32 
51 N 33 
52 0 34 
53 Р 35 
54 Q 36 
55 R 37 
56 S 38 
57 T 39 
58 U 3A 
59 V 3B 
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Table C-1. (Continued) 


Decimal 
Code 


Hexadecimal 
Code 


Character 


60 
61 


62 
63 
64 
65 


66 
67-111 
112 
113 
114 
115 
116 
117 
118 
119 
120 
121 
122 
123 
124 
125 
126 
127 
128 
129 
130 
181 
132 
133 
134 
135 
136 
137 
138 
139 
140 
141 
142 
143 
144 
145 
146 
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ү 
X 
Y 
Z 
RND 
INKEY$ 
PI 
Not used 
cursor up 
cursor down 
cursor left 
cursor right 
GRAPHICS 
EDIT 
ENTER 
DELETE 
B/E mode 
FUNCTION 
not used 
not used 
not used 
not used 
number 
cursor 


EER er Le | 


inverse “ 
inverse £ 
inverse $ 
inverse : 
inverse ? 
inverse ( 
inverse ) 
inverse > 


3C 
3D 
3E 
3F 
40 
41 
42 


70 
71 
72 
73 
74 
75 
76 
77 
78 
79 
ТА 
7B 
ТС 
7D 
7E 
ТЕ 
80 
81 


82 
83 
84 
85 


86 
87 
88 
89 
8A 
8B 
8C 
8D 
8E 
8F 
90 
91 
92 


Table C-1. (Continued) 


Decimal Hexadecimal 
Code Character Code 
147 inverse « 98 
148 inverse — 94 
149 inverse + 95 
150 inverse — 96 
151 inverse * 97 
152 inverse / 98 
153 inverse ; 99 
154 inverse , 9A 
155 inverse . 9B 
156 inverse 0 9C 
157 inverse 1 9D 
158 inverse 2 9E 
159 inverse 3 9F 
160 inverse 4 А0 
161 inverse 5 А1 
162 іпуегве 6 А2 
163 inverse 7 A3 
164 inverse 8 A4 
165 inverse 9 Ab 
166 inverse A A6 
167 inverse B АТ 
168 inverse C A8 
169 inverse D A9 
170 inverse E AA 
171 inverse F AB 
172 inverse G AC 
173 inverse H AD 
174 inverse I AE 
175 inverse J AF 
176 inverse K Во 
177 inverse L Bl 
178 inverse M B2 
179 inverse N B3 
180 inverse O B4 
181 inverse P B5 
182 inverse Q B6 
183 inverse R B7 
184 inverse S B8 
185 inverse T B9 
186 inverse U BA 
187 inverse V BB 
188 inverse W BC 
189 inverse X BD 


ج 
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Table C-1. (Continued) 


_— ————————————-— 


Decimal Hexadecimal 
Code Character Code 
190 inverse Y BE 
191 inverse Z BF 
192 ud со 
198 АТ C1 
194 TAB C2 
195 not used C3 
196 CODE C4 
197 VAL C5 
198 LEN C6 
199 SIN C7 
200 cos C8 
201 TAN C9 
202 ASN CA 
203 ACS CB 
204 ATN CC 
205 LN CD 
206 EXP CE 
207 INT CF 
208 SQR DO 
209 SGN D1 
210 ABS D2 
211 PEEK D3 
212 USR D4 
213 STR$ D5 
214 CHR$ D6 
215 NOT D7 
216 жж D8 
217 OR D9 
218 AND DA 
219 <= DB 
220 >= DC 
221 <> DD 
222 THEN DE 
223 TO DF 
224 STEP EO 
225 LPRINT El 
226 LLIST E2 
227 STOP E3 
228 SLOW E4 
229 FAST E5 
230 NEW E6 
231 SCROLL E7 
232 CONT E8 


Table C-1. (Continued) 


Decimal Hexadecimal 
Code Character Code 
233 DIM E9 
234 REM EA 
235 FOR EB 
236 GOTO EC 
237 GOSUB ED 
238 INPUT EE 
239 LOAD EF 
240 LIST FO 
241 LET Fl 
242 PAUSE F2 
243 NEXT F3 
244 POKE F4 
245 PRINT ЕБ 
246 PLOT F6 
247 RUN F7 
248 SAVE F8 
249 RAND F9 
250 IF FA 
251 CLS FB 
252 UNPLOT FC 
253 CLEAR FD 
254 $ RETURN FE 
255 COPY FF 


SOURCE: Timer User Manual by Steven Vickers, 9 1982, Timex 
Corporation, pp. 137-143. 
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Your Т$1000 or ZX81 computer probably will work perfectly the first time 
you plug it in. However, you may encounter a few problems until you find the 
best combination of settings for the television and the computer. Here are 
some suggestions to help you correct the most common difficulties. 


No Picture 


If the display has nothing on it but "snow," unplug the computer power 
supply from the wall socket and plug in a lamp or other appliance to verify 
that the socket has power. Check that the video cable is securely connected to 
the computer and to the “COMPUTER” terminals on the antenna switch, 
and confirm that the antenna switch is in the “COMPUTER” position. 


Image Off the Screen 


If you still don't see the cursor, your television may be out of adjustment in 
such a way that the picture is too big to fit on the screen. This can cause the 
cursor to disappear off the bottom or side of the screen. It also can make the 
top line or two of a program disappear off the top. To test for this problem, 
turn the vertical control of the television set until the picture "rolls" up or 
down the screen. If you still don't see the cursor, try the same thing with the 
horizontal control. If you can only see the cursor while the screen is unsteady, 
have your set adjusted by a qualified technician. 


_______ И —— 
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Poor Picture 


If a grid of horizontal and vertical lines appears on the screen with the 
cursor, try switching both the television and the computer to the other 
channel. Readjust the fine tuning and the other controls if necessary. If the 
grid is still there, check to make sure that the screws holding the cover on the 
computer are tight and that none of the plug connections between the differ- 
ent parts of the system are loose. A small black-and-white television set often 
gives a much clearer picture than a color set. The display will not be as clear 
if the computer is on a metal table or if there is an electric motor or other 
source of television interference nearby. 


Intermittent Problems 


Occasionally, people have problems with the connection between the com- 
puter and the optional accessories at the back edge connector. If you have the 
printer or the memory expansion pack, and you find that the display some- 
times disappears or the computer stops responding to your commands when 
you jostle or move it, chances are you have a bad connection at the edge 
connector. To improve the connection, first unplug the power. Then remove 
the accessory from the edge connector and clean the metal strips on both 
sides of the connector with a pencil eraser. Be very careful not to cut or 
damage any of the metal foil connections. All you need to do is to remove any 
dirt or oxide that may be on the metal surface. 
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The system variables are locations in read/write memory (RAM) that the 
master program uses for its internal bookkeeping. Chapter 7 describes those 
that BASIC programmers might use and explains how to examine and store 
those that occupy two bytes. BASIC will not work without correct relation- 
ships among the system variables. Consult Chapter 7 or the references in 
Appendix N for further information. 

Table E-1 describes all thesystem variables. The names in the first column 
arefor your useonly. They mean nothing to the computer, in BASIC or in any 
other language. The master program uses only the contents of the addresses. 


Table E-1. System Variables 


Name Address Description 
ЕКЕ NR 16384 You can POKE a number here to stop a program with a 
report code at the lower left corner of thescreen. Thelegal 
codes are 
POKE Value Error Code Displayed 
0to8 1to9 
9 to 14 AtoF 
15to 34 G to Z 
99 to 109 Graphics symbol 
110 to 127 Reverse-video character 
Other POKE values either do nothing or confusethe master 
program. 
FLAGS 16385 Flags (bits set to one or zero to indicate specific conditions) 


for master program bookkeeping. 
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Table E-1. (Continued) 


Name 


ERR. SP 


RAMTOP 


MODE 


PPC 


VERSN 


E. PPC 
D. FILE 


DF. CC 


VARS 


DEST 


E. LINE 
CH... ADD 


X. PTR 
STKBOT 


STKEND 


BREG 
MEM 
Not used 


DF. SZ 
S. TOP 
LAST K 


DEBOUNCE 


Address 
16386-16387 


16388-16389 


16390 


16391-16392 


16393 


16394-16395 
16396-16397 


16398-16399 


16400-16401 


16402-16403 


16404-16405 
16406-16407 


16408-16409 
16410-16411 


16412-16413 


16414 
16415-16416 
16417 


16418 
16419-16420 
16421-16422 


16423 


Description 


Address of the first item on the machine stack (an area for 
temporary storage of values) 


Address of the first byte not used by BASIC. Any read/ 
write memory above this point is protected and available 
for machine language routines. (See Chapter 7.) 


Specifies 8, 8, Ы, or E cursor. 


Line number of the BASIC statement currently being 
executed. 


Version of master program. Identifies 8K ROM in pro- 
grams saved on cassette. 


Number of the BASIC line where the program cursor is. 
Address of the first location in the display file (see Fig- 
ure 7-1). 

Address (in the display file) of the current print position. 
(See Chapter 7.) 

Address of the first location in the BASIC variables area. 
Also the next location after the end of the display file (see 
Figure 7-1). 

Address of the variable currently being processed. 
Address of the beginning of the work space. 


Address of the next character in the string currently being 
processed. 


Address of the character where syntax error occurred. 


Address of the beginning of the calculator stack in the 
work space. 


Address of the top of the calculator stack, which is the 
beginning of available memory. 


Temporary storage while doing calculations. 
Address of another area used for doing calculations. 


The master program does not use this byte. Machine lan- 
guage programmers sometimes use it to pass an argument 
from BASIC to a machine language subroutine. 


The number of lines in the lower part of the screen. 
The number of the top program line in automatic listings. 


The key value (see Appendix M) of the last key that was 
pressed. 


Debounce status of the keyboard. 
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Table E-1. (Continued) 


Name Address Description 

MARGIN 16424 Number of blank lines above or below the picture. 

NXTLIN 16425-16426 Program line that BASIC will execute next. 

OLDPPC 16427-16428 Previous BASIC line number (for the CONT command). 

FLAGX 16429 Flags for master program bookkeeping. 

STRLEN 16430-16431 Length of the string being processed. 

T_ADDR 16432-16433 Address of the next item in the syntax table. 

SEED 16434-16435 Number that determines the sequence produced by RND, 
the random number generator function. The command 
RAND sets the value of SEED. 

FRAMES 16436-16437 Counts the number of frames displayed on the television. 
Used by PAUSE to measure time intervals. When RAND 
is executed without a number for SEED, it uses the value 
of FRAMES. This usually produces a different sequence each 
time. 

COORDS 16438,16439 The X and Y coordinates, respectively, of the last point for 
PLOT. 

PR_CC 16440 The less significant byte of the current address in the 
printer buffer, PRBUFF. 

S. POSN 16441,16442 The column and line numbers, respectively, for the print 
position. 

CDFLAG 16443 Flags for master program bookkeeping, including the 
SLOW mode flag (bit 7). 

PRBUFF 16444-16476 Printer buffer. Machine language subroutines may use 
this area for temporary storage, but printer commands 
and some other BASIC commands will alter its contents. 

MEMBOT 16477-16506 Temporary storage for calculations. 

Not used 16507-16508 The master program does not use these bytes. Machine 


language programmers sometimes use them to pass ar- 
guments from BASIC to a machine language subroutine. 


SOURCE: Timer User Manual by Steven Vickers, € 1982 Timex Corporation, pp. 134-136. 
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This appendix provides convenient programs for loading machine lan- 
guage subroutines such as those in Appendices G and L. It also gives some 
technical information of interest to machine language programmers. 


~ 


MACHINE LANGUAGE LOADER PROGRAMS 


The following are two loader programs. One loads a machine language 
program into a REM statement; the other loads it into space that you reserve 
above RAMTOP. Each program uses a string variable, which must be the 
first variablein the BASIC program. This variable contains the hexadecimal 
representation of the machine language code. 

Each routine in Appendices G and L includes a LET statement (at line 20) 
that defines the machine code for that routine. Read the appropriate loader 
routine from cassette and type in the hexadecimal lines from Appendix G or 
L for the machine language routine you want to use. You must type each line 
exactly as shown, with onespace between each pair of hexadecimal digits. Be 
sure to include a space between the last pair of digits and the closing 
quotation mark. 


REM Loader 


The REM loader program will save you the trouble of typing long REM 
statements and making sure they contain the correct number of characters. 
Use it to load the example programs in Appendix L. The loader program has 
a short machine language routine of its own in the REM statement of line 10. 
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This routine extends the BASIC program area and lengthens the REM state- 
ment in line 200, so that it has exactly the right number of bytes to contain the 
machine language instructions you specify in the string variable H$. To 
create the loader program, start with the following INPUT loop: 


Run it and enter the decimal numbers 42, 130, 64, 205, 155, 9, and 201. 
Now delete lines 20-50 and enter the rest of the program, as follows: 


10 REH 


E 
E 
“ас RAND 
100 POKE 
CODE нфіІз2 
118 NEXT 
120 PORE 
13а PORKE 
eno REH 


Enter this program exactly as it appears above and SAVE it on a cassette. 
When you are ready to enter a machine language program, LoAD the pro- 
gram from tape. Your machine language program will be entered as astring 
variable, using a LET statement in a new line (use line number 20). Here is an 
example of how this would be done using the program entered in Chapter 8: 


| бе 04 СЕ ЕВ г 


Note that the data is entered as hexadecimal numbers. Remember that the 
program requires you to enter a space following the last two digits of the 
program (as in the previous example). 

Appendices G and L give a complete listing of each machine language 
routine for the benefit of machine language programmers who want to see 
how they work. If you have not studied machinelanguage programming, you 
can still enter and use the routines. With the loader program and your line 20 


l2Adapted from Frank O'Hara, Synta.. August, 1982, p. 8, and William Wentz, Syntax Quarterly, Winter, 
1982 (The Harvard Group. Bolton Road, Harvard, Mass. 01451), p. 21. 
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in the computer, execute RUN to translate the hexadecimal code into machine 
language. The loader program extends the REM statement at line 200, which 
must be the last line in the program, and POKES the machine language into it. 
A peculiar line of symbols appears in the REM statement because the comput- 
er treats the bytes of the machine language routine as text. 

To run the machine language program, delete all of the loader program 
except line 200 to make it the first line in the program. This will make the 
machine language routine in the REM statement begin at address 16514. Do 
not insert any BASIC lines before it, or you will change its starting address. 
You can save the REM statement on cassette and load it whenever you want to 
use the machine language program. 


RAMTOP Loader 


If you want to usethesame machine language routine with many different 
BASIC programs, you may prefer to store it in protected space at the top of 
memory instead of in a REM statement. BASIC does not save this part of 
memory, but it also does not clear it when you execute NEW or LOAD. 

The RAMTOP loader automatically 


· determines the length of the machine language routine 

· resets RAMTOP without using NEW or destroying the BASIC program 
* POKES the machine language into the reserved space 

- displays the new value of RAMTOP, where the routine begins. 


The location of the routine in memory will be different on systems that have 
different amounts of read/write memory, so use this method only for routines 
that will run correctly regardless of where they are in memory. The routines 
in Appendix G are all position-independent and can be stored above RAM- 
TOP, but those in Appendix L cannot. 

Like the REM loader program in the previous section, this RAMTOP loader 
begins with a machine language routine of its own in a REM statement. This 
routine resets RAMTOP and relocates the master program's stack. To enter 
the loader program, begin with the following input loop: 


1 


т 


0123 


Ca CO Ch 
M ~. 
көгү 


40 PORE х,Н 
БИ NEST x 


l3Wentz and Roderick McConnell, Syntax, August 1982 (The Harvard Group, Bolton Road, Harvard, 
Mass., 01461), pp. 20-21. 
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Run it and enter the following decimal numbers, from left to right, begin- 
ning with the top row: 


Tes д 25 ЛЕ ФЕ Ed 237 
114 Se ТЕ Ge SY 21 123 
24 227 ар 235 25 184 227 
75 122 84 42 4+ Е4 237 ВЕ 
24 + 24 42 2 64 237 БЕ 
34 = 64 237 28 fF 237 ВВ 
гіс 201 


Delete the INPUT loop, leaving only the REM statement, which now looks like 
line 10 below. Enter the remainder of the following program and SAVE it on 
cassette:!5 


Tite 


КҮЛ) 


лк 
Ul 

TI 
БҮГҮҮ 
1л! 

ж ү 


To use this loader, LOAD it from cassette and enter your hexadecimal code into 
a string variable H$, as shown in the REM loader described above. Save the 
loader program on cassette with the hexadecimal string so you can load the 
same routine again whenever you need it. 

To load your machine language program, run the BASIC program and 
then execute NEW to delete it. The machine language routine will be stored 
above RAMTOP. To determine where your machine language program 
Starts, enter and run the following line in immediate mode: 


INT PEER 16382 + 256 PEEK 1 


Your program will remain there even if you execute NEW or LOAD. Because of 
this, you can load several adjacent routines above RAMTOP by running the 
BASIC program several times with different hexadecimal strings each time. 


Иља, 
fhid. 
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FOR MACHINE LANGUAGE PROGRAMMERS 


The rest of this appendix is for readers who have studied Z80 machine 
language routines for the TS1000 or ZX81. If you want to learn more about 
machine language programming, consult the references in Appendix N. 

As a machine language programmer, you must choose a portion of read/ 
write memory to contain your routine. A REM statement is a good choice 
because the SAVE and LOAD commands preserve it, and because you can easily 
determine the exact memory address where it begins. Make the REM state- 
ment the first line of the BASIC program, and the bytes following the REM 
keyword will always begin at address 16514 (hexadecimal 4082). 

If the byte value 118 occurs in the routine, it breaks the REM statement into 
two lines and changes the display of several bytes following it. The byte value 
126 makes the next five bytes invisible on the display. If either of these is near 
the end of the REM statement, it also affects the display of the following line. 
(Character code 118 represents ENTER, and 126 hides the values of floating 
point constants that the master program stores in the listing.) Programs 
containing these bytes in REM statements will still work correctly, apart from 
the effect on the display. However, you cannot use EDIT to change a REM 
statement that contains 126, because EDIT deletes the byte containing 126 and 
the next five bytes after it. Therefore, design your REM statement programs 
to avoid these byte values. 


A ӨӨ ————— 
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m 


а 


а 


Ы 
vet 


xl 
мађ а S apr 
m 


erging 


Line Renumbering and Program M 


FED 


+ 


ЕА 


ми 


The following routines implement two valuable editing functions for BASIC 
programming. They also demonstrate the machine language capability of 
the TS1000 and 2Х81. 


LINE RENUMBERING 


This machine language renumbering program is similar to the BASIC 
renumbering program used earlier in the book. Because it is in machine 
language, however, it will remain in memory above RAMTOP while you 
enter or load different BASIC programs. 

To use this program, enter it by means of the RAMTOP loader program 
from Appendix F. When you enter line 20, it must look exactly like the 
following lines, including a single space between each pair of digits and а 
space after the last pair: 


After you run the loader program, it will display the usr address of the 
machine language routine. Write this down for future use. The routine 
remains in read/write memory until you disconnect power to the computer. 
To renumber a BASIC program, you will need to enter it into the machine 
by hand or load it from a cassette. Once it is in memory, decide what your new 
starting line will be and give it the variable name FNUM as follows: 


LET FHilMzxExxX 


22222222 -»тт,гфк””>,ҡ>»,->ҡ”ь,,>,>ь>ь>к>ь,>--ькьькьььь-5-5: 
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Replace the X’s in the routine above with your starting value (the number you 
choose must be between 1 and 9999). Then decide what the new line incre- 
ments will be. (The increment may be any value between 1 and 255.) Give 
that value to the variable INC in immediate mode, replacing the X's in the 
following routine with your selected increment value: 


LET МЕКЕ 


Now storethestarting line and increment values in your renumber routine 
by entering these three lines and running them in immediate mode: 


PORE 15508, INT {ЕНИН 2: 
PORE 169287,FHUM-zzosPE 
PORE 26417. IHC 


LESSOR 


With this data in place, you can now renumber any program by executing 
the command RAND USR XX XX XX with the starting address you got earlier 
from the loader routine in place of the X’s. When the display returns, the 
program will have the new line numbers. If it contains any GOTO or GOSUB 
commands, you will need to edit them to make them agree with the new 


numbering. 


The complete machine language listing follows for those readers who wish 
to use it. Each line describes one machine language command. The first 
column gives the hexadecimal contents of the byte or bytes that make up the 
command. The second column shows the standard name (mnemonic) for the 
command, and the last column is a comment explaining the command’s 


function in the subroutine. 


Line Renumbering Routine 


Machine Code Instruction 
11 7D 40 LD DE,407D 
1A LOOP LD A,(DE) 
FE76 CP 76 
C8 RETZ 
2A 7B 40 LD HL,(407B) 
7C LD A,H 
12 LD (DE),A 
13 INC DE 
7D LD A,L 
12 LD (DE),A 
1B DEC DE 
3A 21 40 LD A,(4021) 
4F LDC,A 
06 00 LD B,00 


Comment 


Get address of first BASIC line 
Store first byte of line number in A 
ENTER code means end of program 
Return to caller—all done 

Get new value of line number 

Store it in the program line 

High byte first 


Low byte of number in next location 
Restore starting address of line 

Get line number increment 

Store it in BC 
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Machine Code Instruction Comment 


09 ADD HL,BC Add increment to line number 

22 7B 40 LD (407B),HL Store line number for next line 

EB EX DE,HL Put address of this line into HL 

CD F2 09 CALL NEXT. LINE Get address of next line into DE 

18 E3 JR LOOP Process the next line 
PROGRAM MERGING 


The next routines in this section require at least ӘК of read/write memory. 
Therefore, they will not run on a ZX81 without the 16K memory pack. : 

These machine language routines merge two BASIC programs into a 
single program. You can keep frequently used subroutines on cassette and 
merge them with other programs as you need them. Because these merge 
routines are in machine language, they will remain in memory above RAM- 
TOP, allowing you to enter or load different BASIC programs. 

Once again, use the RAMTOP loader program from Appendix F to load 
each of the two merge routines. Include the hexadecimal code for each 
machine language routine in a string variable. As before, the code must 
appear exactly asshown below, including a singlespace between each pair of 
digits and aspace after the last pair. There are two routines. To load the first 
one, enter the following line: 


Run the loader routine and write down the usr address. Now replace line 20 
with the code of the second merge routine: 


20 LET Негев 04 40 БЕ 23 56 = 
3 ЕЗ B1 7D 40 EB AF ED 52 ES 44 
ар га ас 40 ES 26 CD ЗЕ 0S 21 са 


D 2A 
El ЕГ Be са 


Finally, run the loader again and write down the second USR address. 

The two routines will remain in read/write memory until you disconnect 
power. If you have enough read/write memory, you can keep the renumber 
and the two merge routines in memory at all times in case you need to use 
them. 


س ي ااا 
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LE 


Tom 


numbers and run the first merge routine by entering RAND USR XXXXX, 
using the first number you wrote down in placeof the X's. The routine moves 
RAMTOP down and copies the program into the reserved space. Now exe- 
cute NEW and load or enter the BASIC program with smaller line numbers. 
Run the second merge routine using RAND USR and the second number. The 
computer will copy the previous BASIC program from the reserved space 
and merge it with the current BASIC program. It will also execute the 
previous program before returning to the # cursor. (To prevent this, insert а 
STOP command at the beginning of the higher-numbered program before 
running the first merge routine.) 

The complete machine language listing for these routines follows. 


First Merge Routine 


Machine Code 


2A 0C 40 
11 7B 40 
AF 

ED 52 
ТС 

AT 

20 07 
7D 

FE 14 
30 02 
2E 14 
227B 40 


AF 

CD 23 0F 
2A 04 40 
ED 72 
44 

4D 

03 


Instruction 


LD HL(D. FILE) 
LD DE,407B 
XORA 

SBC HL,DE 

LD A,H 

ANDA 

JR NZLEN. OK 
LDA,L 

CP 14 

JR NC,LEN_OK 
LD L, 14 

LEN. OK LD (407B),HL 


XOR A 

CALL FAST_MODE 
LD HL(RAMTOP) 
SBC HL,SP 

LD B,H 

LD C,L 

INC BC 


Comment 
Part 1: Find length of program 


Get next address after program area 
Get address of start of program — 2 
Clear carry flag 

Calculate length of program + 2 
Must not try to reserve < 20 bytes 


If length < 20, reserve 20 bytes 
Store length 


Part 2: Move RAMTOP down 


Clear carry flag 

Go into fast mode 

Get value of RAMTOP 

Subtract SP to get length of stacks 
Transfer length to BC 


Add one to length 
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Machine Code 


39 

ED 5B 7B 40 
ED 52 

EB 

19 

ED B8 

ED 4B 7B 40 
2A 04 40 

ED 42 

22 04 40 

2A 02 40 

ED 42 

22 02 40 

ED 62 

39 

ED 42 

F9 


ED 5B 04 40 
21 0C 40 


ED A0 
ED AO 
2170 40 
ED BO 
C9 


Second Merge Routine 


Machine Code 


2A 04 40 
5E 


23 

56 

23 

E5 

21 7D 40 
EB 
AF 
ED 52 
Е5 

44 

4D 


Instruction 


ADD HL.SP 

LD DE,(407B) 
SBC HL,DE 

EX DE,HL 

ADD HL,DE 
LDDR 

LD BC,(407B) 

LD HL(RAMTOP) 
SBC HL,BC 

LD (RAMTOP),HL 
LD HL(ERR. SP) 
SBC HL,BC 

LD (ERR. SPJHL 
SBC HLHL 

ADD HL,SP 

SBC HL,BC 

LD SP,HL 


LD DE (RAMTOP) 
LD HL,D_FILE 


LDI 

LDI 

LD HL,407D 
LDIR 

RET 


Instruction 


LD HL(RAMTOP) 
LD E,(HL) 


INC HL 

LD D,(HL) 
INC HL 
PUSH HL 
LD HL,407D 
EX DE,HL 
XOR A 
SBC HL,DE 
PUSH HL 
LD B,H 

LD C,L 
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Comment 


Restore value of RAMTOP to HL 
Get size of space to reserve 
Subtract to get new value of RAMTOP 
Store new RAMTOP value in DE 
Restore old RAMTOP value to HL 
Move stack down to new RAMTOP 
Get size of reserved space 

Get old value of RAMTOP 
Calculate new value of RAMTOP 
Store new value 

Get old value of ERR. SP 
Calculate new value of ERR_SP 
Store new value 

Clear HL 

Load stack pointer into HL 
Calculate new value of stack pointer 
Store new value 


Part 3: Copy program above RAMTOP 


Get new value of RAMTOP 

Get address of D. FILE system 
variable 

Copy Ы. FILE into reserved space 


Get starting address of program 
Copy program into reserved space 
Return to BASIC 


Comment 


Get new value of RAMTOP 
Copy old D. FILE from reserved 
space 


HL now contains address of old program 
Store address on stack 

Get address of program storage area 
Prepare to subtract 

Clear carry 

Calculate length of old program 

Store length on stack 

Transfer length to BC 


Machine Code Instruction Comment 


2A 0C 40 LD HL,(D. FILE) Get address of end of current program 

E5 PUSH HL Store end address on stack 

2B DEC HL Point to actual last byte 

CD 9E 09 CALL 099E Make space for old program at end of 
new program 

D1 POP DE Get starting address of space 

Cl POP BC Get length of old program 

El POP HL Get starting address of old program 

ED BO LDIR Copy old program into space 

C9 RET Return to BASIC 
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MUTO 
Meca 


EE 
leve 


rmat 


A 


n 


Floating Poin 


Most of the time, when you are using the TS1000 or ZX 81 computer, the way 
that numbers are stored in memory is of no importance. This is because you 
can assign values to variables and use them simply by naming the variable. 
Or if you need to use a constant, simply enter the value and away you go. If you 
are dealing with the computer on a more detailed level, however, you may 
need to understand how numbers are stored within BASIC statements. 

The way that numbers are stored in the TS1000 and ZX81 computers is 
called floating point format. 

Floating point format is similar to scientific notation except that it uses the 
binary number system (base 2) instead of the decimal number system (base 
10). It takes five bytes to store numbers in ZX81/TS1000 floating point 
format. These five bytes are located in the BASIC program after the charac- 
ter code bytes for the value. 

The first of the five bytes contains the binary exponent, and the next four 
bytes contain the binary mantissa. The mantissa is the binary representation 
of the number without regard for the binary point, beginning with the first 
nonzero digit and padded with zeros on the right. The first binary digit ofthe 
mantissa is changed to zero for positive numbers to distinguish them from 
negative numbers. For most numbers, the exponent is determined by adding 
128 to the number of binary digits on the left of the binary point. For numbers 
between —1 and 1 (excluding zero), the exponent is 128 minus the number of 
zeros between the binary point and the first nonzero digit to its right. The 
number zero is a special case, with all five of its bytes being zero. 

Table H-1 gives some examples of floating point format. 
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Table H-1. Examples of Floating Point Format 


Decimal Number 


—5 
—4 
—3 
—2 
-і 
—1/2 
—1/4 


131 
131 
130 
130 
129 
128 
127 
126 

0 
126 
127 
128 
129 
130 
130 
131 
131 
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160 
128 
192 
128 


oooo coco ож eco coca о о о 


200000000000000000o 


Five-Byte Floating Point Representation 


02000000000 сос 


I VETE. E 


bles 


i 


for BASIC Var 


E 


И 
ҒЫ ҒҒ Қа 


i 
uc ir 


Trag 


ats 


їз 


rage Form 


Ede 


n 


$ 
4 
+ 


М 


The master program of the TS1000 and ZX81 stores the BASIC variables 
in read/write memory. The BASIC commands LET and INPUT create vari- 
ables in this area. Machine language programmers can use the BASIC 
variables to communicate with a BASIC program, and the BASIC program 
itself may even PEEK and POKE into the variable storage area for special 
purposes. 

The system variable VARS gives the address of the beginning of the 
BASIC variables area, and thesystem variable E. LINE gives the address of 
the next byte after the end of this area (see Appendix E). 

Within the BASIC variables area, each typeof variable has its own format. 
For example, each single variable or array begins with the character codes 
for the variable’s name. The three highest bits of the first character contain a 
code that identifies the type of variable. Some types of variables have special 
information right after the variable name. For example, an array variable 
has information about its dimensions, while a string variable has two bytes 
containing its length followed by its value. For strings, the value is the 
character codes of the characters in thestring. As discussed in Appendix H, 
numeric variables occupy five bytes in a special format. 

Figures I-1 through 1-6 show the storage format for each kind of BASIC 
variable. They are adapted from the Timex User Manual by Steven Vickers 
(Timex Corporation, 1982), pp. 129-31. 


س = ___________________________ 
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Sign bit 


"EHI Exponent byte | 4 Mantissa bytes 


Letter 


Figure I-1. Numeric variable with a one-letter name 


Letter 
character character 


Figure I-2. Numeric variable with a longer name 


2 bytes | 1 byte 5 bytes each 


Letter-20h Total No. of 1st dim. Last dim. Elements 


length of dimensions 
elements & 
dimensions 
t 1 for no. 
of dimensions 


Figure I-3. Numeric array 
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More significant 
Less significant 


—— / = — 


Figure I-4. FOR-NEXT loop control variable 


Letter-20h ' Number of 
characters 


MESE A 
Text of string (may be empty) 


Figure 1-5. String variable 


а i ad 


Letter-20h Total No.of  1stdim. Last dim. Elements 


number of dims. 
elements 
& dims. + 

1 for no. 

of dims. 


Figure 1-6. String array 
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Tables 


nversion 


Hexadecimal Co 


In the summary of instructions built into the Z80 microprocessor, given in 
Appendix K, the numeric values of the instructions are given in hexadecimal 
notation. Descriptions of the contents of computer memory locations often 
use hexadecimal notation as well. This number system, based on 16, relates 
more directly to thesettings of the individual bits than does decimal notation, 
and it conveniently represents each byte with only two digits. 

The familiar decimal system uses powers of 10. Each digit represents 1’s, 
10's, 100's, and so on, depending on its position in the number. The hexadec- 
imal system uses powers of 16 instead. Each hexadecimal digit represents 
1's, 16's, 256's, and so on (powers of 16). In addition to the digits 0-9, hexadec- 
imal notation uses the single digits A, B, C, D, E, and F to represent the 
(decimal) numbers 10, 11, 12, 13, 14, and 16. 

This appendix contains the following tables: 


- Hexadecimal-binary numbers (Table J-1) 

- Hexadecimal-decimal integers (Table J-2) 

- Powers of 2 (Table J-3) 

- Useful mathematical constants in decimal and hexadecimal (Table J-4) 
- Powers of 16 (Table J-5) 

- Powers of 10 (Table J-6). 


Use Table J-1 to make conversions between hexadecimal numbers in the 
range 00-OFF and binary numbers in the range 0000-1111. 

Convert larger binary numbers to hexadecimal numbers by converting 
four binary digits at a time, working from right to left. If there are fewer 


et 
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than four binary digits in the leftmost group, add leading zeros. Here is an 
example (the subscripts indicate which number system is being used): 


100101, — 00100101, 


Convert hexadecimal numbers larger than OF to binary one digit at a time. 
Here is an example: | 


010 оп 


= 


01100111, 


Table J-1. Hexadecimal-Binary Conversion 


Hexadecimal Binary Hexadecimal Binary 
00 0000 08 1000 
01 0001 09 1001 
02 0010 0А 1010 
08 0011 0В 1011 
04 0100 0С 1100 
05 0101 0D 1101 
06 0110 0E 1110 
07 0111 OF 1111 


| ا 
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Table J-2. Hexadecimal-Decimal Integer Conversion 


Tre toc'e below provides for direct conversions between hexo- Hexadecimal fractions may be converted to decimal fractions 
secimal integers in tne range O-FFF and decimal integers in as follows: 
tre range 0-4095, For conversion of larger integers, the 
tacle values moy be added to the following figures: 1. Express the hexadecimal fraction as an integer times 
1677, where n is the number of significant hexadecimal 
Hexagecimal Decimal Hexodecimal Decimal places to the right of the hexodecimol point. 
e! 090 4 096 20 000 131 072 0. САВЕЗ + = САФ ВЕЗ 6 x 1679 
02 000 8 192 30 000 196 608 
03 000 12 288 40 000 262 144 2. Find the decimal equivalent of the hexadecimal integer 
04 000 16 384 50 000 327 680 
05 000 20 480 60 000 393 216 CA9 ВЕЗ 6 = 13278 195,9 
06 000 24 576 70 000 458 752 
07 000 28 672 80 000 524 288 3. Multiply the decimal equivolent by 167^ 
28 000 32 768 90 000 589 824 
09 000 36 864 А0 000 655 360 13 278 195 
0A 000 40 960 80 000 720 896 х 596 046 448 x 10-16 
ов 000 45 056 Со 000 786 432 0.791 442 0%) 4 
OC 000 49 152 DO 000 851 968 
59 000 53 248 EO 000 917 504 Decimal fractions may be converted to hexodecimol fractions 
ОЕ 000 57 344 FO 000 983 040 by successively multiplying the decimal fraction by lóig 
OF 000 61 440 100 000 1 048 576 After each multiplication, the integer portion is removed to 
10 000 65 536 200 000 2097 152 form a hexadecimal fraction by building to the right of the 
1 000 69 632 300 000 3 145 728 hexadecimal point. However, since decimal arithmetic is 
12 000 73 728 400 000 4 194 304 used in this conversion, the integer portion of each product 
3 000 77 824 500 000 5 242 880 must be converted to hexodecimal numbers. 
4 000 81 920 600 000 6 291 456 
5 000 B6 016 700 000 7 340 032 Exomple: Convert 0.89519 to its hexadecimal equivalent 
16 000 90 112 800 000 8 388 608 0.895 
17 000 94 208 900 000 9 437 184 
8 000 98 304 A00 000 10 485 760 EE 
19 000 102 400 800 000 11 534 336 
1A 000 106 496 соо 000 12 582 912 Caz 
B 000 110 592 000 000 13 631 488 / 
1C 000 114 488 E00 000 14 680 064 о 
1D 000 118 784 FOO 000 15 728 640 / 
ЈЕ 000 122880 1 000 000 16777 216 od СЕРІ 
ЈЕ 000 126 976 2 000 000 33 554 432 16 
0 1 2 3 4 5 6 7 8 9 A B с D E F 


00 0000 0001 0002 0003 0004 0005 0006 0007 0008 0009 0010 0011 0012 0013 0014 0015 
01 0016 0017 0018 0019 0020 0021 0022 0023 0024 0025 0026 0027 0028 0029 0030 003! 
02 0032 0033 0034 0035 0036 0037 0038 0039 0040 0041 0042 0043 0044 0045 0046 0047 
03 0048 0049 0050 0051 0052 0053 0054 0055 0056 0057 0058 0059 0060 0041 0062 0063 


04 0064 0065 0066 0067 0068 0069 0070 0071 0072 0073 0074 0075 0076 0077 0078 (X79 
05 0080 008! 0082 0083 0084 0085 0086 0087 0088 0089 0090 0091 0092 0093 0094 0095 
06 0095 0097 0098 0099 0100 0101 0102 0103 0104 0105 016 0107 0108 0109 0110 0111 
07 0112 0113 0114 0115 0116 0117 0118 0119 0120 0121 0122 0123 0124 0125 0126 0127 


08 0128 0129 0130 0131 0132 0133 0134 0135 0136 0137 0138 0139 0140 0141 0142 0143 
09 0144 0145 Ol46 0147 0148 0149 0150 0151 0152 0153 0154 0155 0156 0157 0158 0159 
ОА 0160 0161 0162 0163 0164 0165 0166 0167 0168 0169 0170 0171 0172 0173 0174 0175 
ов 0176 0177 0178 0179 0180 0181 0182 0183 0184 0185 0186 0187 0188 0189 0190 0191 


ос 0192 0193 0194 0195 0196 0197 0198 0199 0200 0201 0202 0203 0204 0205 0206 0207 
0D 0208 0209 0210 0211 0212 0213 0214 0215 0216 0217 0218 0219 0220 0221 0222 0223 
OE 0224 0225 0226 0227 0228 0229 0230 0231 0232 0233 0234 0235 0236 0237 0238 0239 
OF 0240 0241 0242 0243 0244 0245 0246 0247 0248 0249 0250 0251 0252 0253 0254 0255 


aS 
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Table J-2. (Continued) 


дм 
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Table J-2. (Continued) 


= 
0 1 2 3 4 5 6 2 8 9 A B G D Е | 

4 

4c 1024 1025 1026 1027 1028 1029 1030 1031 1032 1033 1034 1035 1036 1037 1038 103% 
41 1040 1041 1042 1043 1044 1045 1046 1047 1048 1049 1050 1051 1052 1053 1054 1055 
42 1056 1057 1058 1059 1060 1061 1062 1063 1064 1065 1066 1067 1068 1069 1070 1071 
43 1072 1073 1074 1075 1076 1077 1078 1079 1080 1081 1082 1083 1084 1085 1086 1087 
44 1088 1089 1090 1091 1092 1093 1094 1095 1098 1097 1098 1099 1100 1101 1102 1103 
45 1104 1105 1106 1107 1108 1109 1110 111! 1112 1113 1114 1115 1116 1117 1118 1119 
46 1120 1121 1122 1123 1124 1125 1126 1127 1128 1129 1130 113! 1132 1133 1134 1135 
47 1136 1137 1138 1139 1140 1141 1142 1143 1144 1145 1146 1147 1148 1149 1150 1151 
48 1152 1153 1154 1155 1156 1157 1158 1159 1160 1161 1162 3163 1164 1165 1166 1167 
49 1168 1169 1170 1171 1172 1173 1174 1175 1176 1177 1178 1179 1180 1181 1182 1183 
4А 184 1185 1186 1187 1188 1189 1190 1191 1192 1193 1194 1195 1196 1197 1198 1199 
48 200 1201 1202 1203 1204 1205 1206 1207 1208 1209 1210 1211 1212 1213 1214 1215 
4C 1216 1217 1218 1219 1220 1221 1222 1223 1224 1225 1226 1227 1228 1229 1230 1231 
AU 1232 1233 1234 1235 1236 1237 1238 1239 1240 1241 1242 1243 1244 1245 1246 1247 
4Е 1248 1249 1250 1251 1252 1253 1254 1255 1256 1257 1258 1259 1260 1261 1262 1263 
4F 264 1265 1265 1267 1268 1269 1270 1271 1272 1273 1274 1275 1276 1277 1278 1279 
50 1280 1281 1282 1283 1284 1285 1286 1287 1288 1289 1290 1291 1292 1293 1294 1295 
51 1296 1297 1298 1299 1300 1301 1302 1303 1304 1305 1306 1307 1308 1309 1310 1311 
52 1312 1313 1314 1315 i316 1317 1318 1319 1320 1321 1322 1323 1324 1325 1326 1327 
53 328 1329 1330 133! 1332 1333 1334 1335 1336 1337 1338 1339 1340 1341 1342 1343 
54 1344 1345 1346 1347 1348 1349 1350 1351 1352 1353 1354 1355 1356 1357 1358 1359 
55 1360 1361 1362 1363 1364 1365 1366 1367 1368 1369 1370 1371 1372 1373 1374 1375 
56 1376 1377 1378 1379 1380 1381 1382 1383 1384 1385 1386 1387 1388 1389 1390 139! 
57 1392 1393 1394 1395 1396 1397 1398 1399 1400 1401 1402 1403 1404 1405 1406 1407 
58 1408 1409 1410 1411 1412 1413 1414 1415 1416 1417 1418 1419 1420 1421 1422 1423 
55 1424 1425 1426 1427 1428 1429 1430 1431 1432 1433 1434 1435 1436 1437 1438 1439 
5A 1440 144] 1442 1443 1444 1445 1446 1447 1448 1449 1450 1451 1452 1453 1454 1455 
58 1456 1457 1458 1459 1460 1461 1462 1463 1464 1465 1466 1467 1468 1469 1470 1471 
5С 1472 1473 1474 1475 1476 1477 1478 1479 1480 1481 1482 1483 1484 1485 1486 1487 
1488 1489 1490 1491 1492 1493 1494 1495 1496 1497 1498 1499 1500 1501 1502 1503 

1504 1505 1506 1507 1508 1509 1510 1511 1512 1513 1514 1515 1516 1517 1518 1515 

1520 1521 1522 1523 1524 1525 1526 1527 1578 1529 1530 1531 1532 1533 1524 1535 

60 1536 1537 1538 1539 1540 1541 1542 1543 1544 1545 1546 1547 1548 1549 1550 1551 
61 1552 1553 1554 1555 1556 1557 1558 1559 1560 156! 1562 1563 1564 1565 1500 1557 
62 1568 1569 1570 1571! 1572 1573 1574 1575 1576 1577 1578 1579 1580 158! 1582 1583 
63 1584 1585 1586 1587 1588 1589 1590 159) 1592 1593 1594 1595 1596 1597 1598 1599 
64 1600 1601 1602 1603 1604 1605 1606 1607 1608 1609 1610 1611 1612 1613 1614 1615 
65 1616 1617 1618 1619 1620 1621 1622 1623 1624 1625 1626 1627 1628 1629 1630 1631 
66 1632 1633 1634 1635 1636 1637 1638 1639 1640 1641 1642 1643 1644 1645 1646 1647 
67 1648 1649 1550 1651 1652 1653 1654 1655 1656 1657 1658 1659 1660 1661 1567 1663 
68 1664 1665 1666 1667 1668 1669 1670 1671 1672 1673 1674 1675 1676 1677 1678 1679 
69 1680 1681 1682 1683 1684 1685 1685 1687 1688 1689 1690 1691 1692 1693 1694 1695 
6A 16% 1697 1698 1699 1700 1701 1702 1703 1704 1705 1706 1707 1708 1709 1710 1711 
68 1712 1713 1714 1715 1716 1717 1718 1719 1720 1721 1722 1723 1724 1225 1726 1727 
6C 1728 1729 1730 1731 1732 1733 1734 1735 1736 1737 1738 1739 1740 1741 1742 1/43 
50 1744 1745 1746 1747 1748 1749 1750 1751 1752 1753 1754 1755 1756 1757 1758 1759 
ФЕ 1760 1761 1762 1763 1764 1765 1766 1767 1768 1769 1770 1771 1772 1773 1774 1/5 
6F 1776 1777 1778 1779 1780 1781 1782 1783 1784 1785 1786 1787 1788 1789 1790 1791 

|t peus uU we к ешш ы ш ————À 


NNN 2 _ >= AA 
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Table J-2. (Continued) 


0 1 2 3 4 5 6 7 8 9 A В с D Е F 
[ж | 1792 1793 1794 1795 17% 1797 1798 1799 1800 1801 1802 1803 1804 1805 1806 1807 
71 | 1808 1809 1810 1811 1812 1813 1814 1815 1816 1817 1818 1819 1820 1821 1822 1823 
72 | 1824 1825 1826 1827 1828 1829 1830 1831 1832 1833 1834 1835 1836 1837 1838 1839 
73 | 1840 1841 1842 1843 1844 1845 1846 1847 1848 1849 1850 1851 1852 1853 1854 1855 
74 | 1856 1857 1858 1859 1860 1861 1862 1863 1864 1865 1866 1867 1868 1869 1870 1871 
75 | 1872 1873 1874 1875 1876 1877 1878 1879 1880 1881 1882 1883 1884 1885 1886 1887 
76 | 1888 1889 1890 1891 1892 1893 1894 1895 18% 1897 1898 1899 1900 1901 1902 1903 
77 | 1904 1905 1906 1907 1908 1909 1910 1911 1912 1913 1914 1915 1916 1917 1918 1919 
78 | 1920 1921 1922 1923 1924 1925 1926 1927 1928 1929 1930 1931 1932 1933 1934 1935 
79 | 1936 1937 1938 1939 1940 1941 1942 1943 1944 1945 1946 1947 1948 1949 1950 1951 
7A | 1952 1953 1954 1955 1956 1957 1958 1959 1960 1961 1962 1963 1964 1965 1966 1967 
78 | 1968 1969 1970 1971 1972 1973 1974 1975 1976 1977 1978 1979 1980 1981 1982 1983 
7C | 1984 1985 1986 1987 1988 1989 1990 1991 1992 1993 1994 1995 1996 1997 1998 1999 
7D | 2000 2001 2002 2003 2004 2005 2006 2007 2008 2009 2010 2011 2012 2013 2014 2015 
7E | 2016 2017 2018 2019 2020 2021 2022 2023 2024 2025 2026 2027 2028 2029 2030 2031 
7F | 2032 2033 2034 2035 20% 2037 2038 2039 2040 2041 2042 2043 2044 2045 2046 2047 
A 
во | 2048 2049 2050 2051 2052 2053 2054 2055 2056 2057 2058 2059 2060 2061 2062 2063 
81 | 2064 2065 2066 2067 2068 2069 2070 2071 2072 2073 2074 2075 2076 2077 7078 2079 
82 | 2080 2081 2082 2083 2084 2085 2086 2087 2088 2089 2090 2091 2092 2093 2094 2095 
вз | 2096 2097 2098 2099 2100 2101 2102 2103 2104 2105 2106 2107 2108 2109 2110 2111 
84 | 2112 2113 2114 2115 216 2117 2118 2119 2120 2121 2122 2123 2124 2125 2126 2127 
85 | 2128 2129 2130 2131 2132 2133 2134 2135 2135 2137 2138 2139 2140 2141 2142 2143 
86 | 2144 2145 2146 2147 2148 2149 2150 2151 2152 2153 2154 2155 2156 2157 2158 2159 
87 | 2160 2161 2162 2163 2164 2165 2166 2167 2168 2169 2170 2171 2172 2173 2174 2175 


94 2368 2369 2370 2371 
95 2384 2385 2386 2387 
96 2400 2401 2492 2403 
97 2416 2417 2418 2419 
98 2432 2433 2434 2435 
% 2448 2449 2450 2451 
9A 2464 2465 2466 2467 
98 2480 2481 2482 2483 
9c 2496 2497 2498 2499 
9D 2512 2513 2514 2515 
9E 2528 2529 2530 2531 
F 2544 2545 2546 2547 


2374 2375 2376 2377 2378 2379 2380 2381 2382 2383 
2390 2391 2392 2393 2394 2395 2396 2397 2398 2399 
2406 2407 2408 2409 2410 2411 2412 2413 2414 2415 
2422 2423 2424 2425 2426 2477 2428 2429 2430 2431 
2438 2439 2440 2441 2442 2443 2444 2445 2446 2447 
2454 2455 2456 2457 2458 2459 2460 2461 2462 2463 
2470 2471 2472 2473 2474 2475 2476 2477 2478 2479 
2486 2487 2488 2489 2490 2491 2492 2493 2494 2495 
2502 2503 2504 2505 2506 2507 2508 2509 2510 2511 
2518 2519 2520 2521 2522 2523 2524 2525 2526 2527 
2534 2535 2536 2537 2538 2539 2540 2541 2542 2543 
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Table J-2. (Continued) 


o 1 ? 3 4 5 6 7 8 9 A B C 2 t ' 
А) 2554 2565 2566 2567 2568 2569 2570 2571 2572 2573 2574 2575 
А 2580 2581 2582 2583 2584 2585 2586 2587 2588 2589 2590 2591 
АТ 25960 2597 2598 2599 2600 260! 2602 2603 2604 2605 2606 2607 
A3 2612 2613 2614 2615 2616 2617 2618 2619 2620 2621 2622 2623 
А4 2624 2625 2626 2627 2628 2629 2630 263: 2632 2633 2634 2635 2636 2637 2638 2639 
AS 2640 2641 2642 2643 2644 2645 2646 2647 2648 2649 2650 2651 2652 2653 2654 2655 
Ao 2656 2657 2658 2659 2660 2661 2662 2663 2664 2665 2666 2667 2668 2669 2670 2671 
А? 2672 2673 2674 2675 2676 2677 2678 2679 2680 268! 2682 2683 2684 2685 2686 2687 
AB 2688 2589 2690 2691 2692 2693 2694 2695 2696 2697 2698 2699 2700 270) 2702 2703 
А9 27 2705 2706 2707 2708 2709 2710 2711 2712 2713 2714 2715 2716 2717 2718 2719 
AA 2720 2721 2722 2723 2724 2725 2726 2727 2728 2729 2730 2731 2732 2733 2734 1735 
AB 2736 2737 2738 2739 2740 2741 2742 2743 2744 2745 2746 2747 2748 2749 2750 2751 
AC 2752 2753 2754 2755 2756 2757 2758 2759 2760 2761 2762 2763 2764 2765 2766 2767 
AD 2768 2769 2770 2771 2772 2773 2774 2775 27768 2777 2778 2779 2780 278! 2782 2783 
AE 2784 2785 2786 2787 2788 2789 2790 279! 2792 2793 2794 2795 2796 2797 2798 2799 
АР 2800 2801 2802 2803 2804 2805 2806 2807 2808 2809 2810 281! 2812 2813 2814 2815 
—_—————— ———————————————є- 
BO 2816 2817 2818 2819 2820 2821 2822 2823 2824 2825 2826 2827 2828 2829 2830 2831 
BI 2832 2833 2834 2835 2835 2837 2838 2839 2840 2841 2842 2843 2844 2845 2846 2847 
B2 2848 2849 2850 2851 2852 2853 2854 2855 2856 2857 2858 2859 2860 2861 2862 2863 
83 2864 2865 2866 2867 2868 2869 2870 2871 2872 2873 2874 2875 2876 2877 2878 2879 
84 2880 2881 2882 2883 2884 2885 2886 2887 2888 2889 2890 2891 2892 2893 2894 2895 
85 2896 2897 2898 2899 2900 2901 2902 2903 2904 2905 2906 2907 2908 2909 2910 2911 
86 2912 2913 2914 2915 2916 2917 2918 2919 2920 2921 2922 2923 2924 2925 2926 2927 
87 2928 2929 2930 2931 2932 2933 2934 2935 2935 2937 2938 2939 2940 2941 2942 2943 
88 2944 2945 29% 2947 2948 2949 2950 2951 2952 2953 2954 2955 2956 2957 2958 2959 
B9 2990 2961 2952 2963 2964 2965 2966 2967 2968 2959 2970 2971 2972 2973 2974 2975 
BA 2976 2977 2978 2979 2980 2981 2982 2983 2984 2985 2986 2987 2988 2989 2990 2991 
8B 2992 2993 2994 2995 29% 2997 2998 2999 3000 3001 3002 3003 3004 3005 3006 3007 
BC 3008 3009 23010 301! 3012 3013 3014 3015 3016 3017 3018 3019 3020 3021 3022 30:3 
BD 3024 3025 3026 3027 3028 3029 3030 3031 3032 3033 3034 3035 30% 3037 3038 3039 
BE 3040 3041 3042 3043 3044 3045 3046 3047 3048 3049 3050 3051 3052 3053 3054 3055 
BF 3055 3057 3058 3059 3060 3061 3062 3063 3064 3065 3055 3067 3068 3069 3070 307! 
—— — ——————.———————————-—-_—-е-_— 
со 3072 3073 3074 3075 3076 3077 3078 3079 3080 3081 3082 3083 3084 3085 3086 3087 
с 3088 3089 3090 3091 309? 3093 3094 3095 30% 3097 3098 3099 3100 310! 310? 3103 
C2 3104 3105 3106 3107 3108 3109 3110 311) 3112 3113 3114 3115 316 3117 3118 3119 
C3 3120 3121 3122 3123 3124 3125 3126 3127 3128 3129 3130 313) 3132 3133 3134 3135 
C4 3136 3137 3138 3139 3140 3l4l 3142 3143 3144 3145 3146 3147 3148 3149 23150 3151 
C5 3152 3153 3154 3155 3156 3157 3158 3159 3160 3161 3162 3163 3164 3165 3166 3167 
Có 3168 3169 3170 317! 3172 3173 3174 3175 3176 3177 3178 3179 3180 318! 3182 3183 
с? 3184 3185 3186 3187 3188 3189 3170 3191 3192 3193 3194 3195 3196 3197 3198 3199 
C8 3200 3201 3202 3203 3204 3205 3206 3207 3208 3209 3210 3211 3212 3213 3214 3215 
C9 3216 3217 3218 3219 3220 3221 3222 3223 3224 3225 3226 3277 3228 3229 3230 2231 
CA 3232 3233 3234 3235 3236 3237 3238 323? 3240 3241 3242 3243 3244 3245 3246 3247 
CB 3248 3249 3250 325! 3252 3253 3254 3255 3256 3257 3258 3259 3260 3261 3:62 3263 
cc 3264 3265 3266 3267 3268 3269 3270 3271 2272 3273 3274 3275 3275 3277 3278 3:79 
ср 3280 3281 3282 3283 3284 3285 3286 3287 3288 3289 3270 3291 3292 3293 3294 3295 
CE 3296 3297 3298 3299 3300 3301 3302 3303 3304 3305 3306 3307 3308 3309 3310 3311 
CF 3312 3313 3314 3315 3316 3317 3318 23319 3320 3321 3322 3323 3324 3325 33% 332 
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Table J-2. (Continued) 


0 1 2 3 4 5 6 7 8 9 А B С D E F 
DO 3328 3329 3330 3331 3332 3333 3334 3335 3336 3337 3338 3339 3340 3341 3342 3343 
D! 3344 3345 3346 3347 3348 3349 3350 3351 3352 3353 3354 3355 3356 3357 3358 3359 
D2 3360 3361 3362 3363 3364 3365 3356 3367 3368 3369 3370 3371 3372 3373 3374 3375 
D3 3376 337 3378 3379 3380 3381 3382 3383 3384 3385 3386 3387 3388 3389 3390 3391 
04 3392 3393 3394 3395 3396 3397 3398 3399 3400 3401 3402 3403 3404 3405 3406 3407 
05 3408 3409 3410 3411 3412 3413 3414 3415 3416 3417 3418 3419 3420 3421 3422 3423 
0% 3424 3425 3426 3427 3428 3429 3430 3431 3432 3433 3434 3435 3436 3437 3438 3439 
D7 3440 3441 3442 3443 3444 3445 3446 3447 3448 3449 3450 345! 3452 3453 3454 3455 
D8 3456 3457 3458 3459 3460 3461 3462 3463 3464 3465 3466 3467 3468 3469 3470 347! 
09 3472 3473 3474 3475 3476 3477 3478 3479 3480 3481 3482 3483 3484 3485 3486 3487 
DA 3488 3489 3490 3491 3492 3493 3494 3495 3496 3497 3498 3499 3500 3501 3502 3503 
DB 3504 3505 3506 3507 3508 3509 3510 3511 3512 3513 3514 3515 3516 3517 3518 3519 
DC 3520 3521 3522 3523 3524 3525 3526 3527 3528 3529 3530 3531 3532 3533 3534 3535 
DO 3536 3537 3538 3539 3540 3541 3542 3543 3544 3545 3546 3547 3548 3549 3550 3551 
DE 3552 3553 3554 3555 3556 3557 3558 3559 3560 3561 3562 3563 3564 3565 3566 3567 
DF 3568 3569 3570 3571 3572 3573 3574 3575 3576 3577 3578 3579 3580 3581 3582 3583 
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Table J-3. Powers of Two 


rt 

1 ото 

4 1 05 

4 2 025 
8 3 0125 
16 4 0062 
32 5 0.031 
64 6 0015 
8 7 000 
256 8 0.003 
512 0.001 
1 074 10 0.000 
2 048 11 0.000 


4 294 967 296 32 0.000 
۾‎ 589 934 Ут 33 0000 
17 179 609 184 34 0.000 
34 359 738 368 35 0.000 


- 
$ 
E 
5 
s 
ё 
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3888 8888 8888 8888 8888 8888 8888 8888 8888 8888 


8888 8888 8888 8888 8888 8888 8888 8888 88 


8888 8888 8888 


8888 
8888 


8888 8888 


5 
25 


625 
325 
156 25 
078 125 


039 062 5 
519 531 25 
79 765 625 


773 602 981 120 347 976 684 570 312 5 
886 80) 490 560 173 988 342 285 156 25 
443 400 745 280 086 994 171 142 578 125 


Table J-4. Mathematical Constants 


Corsten Decimal Velve Hexadecimal Valve 
4 3.14159 24535 99773 3.249 ва 
qu 0.31830 9834! 8370 0.970 CAN 
+ 1.77245 38507 03514 1.CS PIC 
las 1,14472 99858 49400 1.2500 ома 
. 2.71828 оты 59045 2478) 542 
n 0.36787 94411 71442 — 0.520 5009 
ж“ 1.64872 12707 00178 — 1.4412 92 
logge 0.42429 44819 03252 0620 ЕС55 
logje 1.44209 50408 MENO 1.7154 7459 
Y 0.57721 560649 01533 0,904 674 
Inv -0.5495) 93129 81645 — -O.BCAE MC! 
4T 1.41421 35423 73095 1.6409 1668 
In? 0.69314 71805 57945 0.8172 1778 


log, o2 0.30102 99956 6398! 0.4010 4042 
ATO 3.1422? 76601 68379 2.2998 оз 
In 10 2.30254 40929 94046 2.4075 177 


Table Ј-5. Powers of Sixteen 


16° n 167" 

то 0.10000 00000 00000 00000 x 10 
16 | 0.62500 00000 00000 00000 x 10^! 
256 2 0.9062 50000 00000 00000 x 1072 
4 096 з 0.24414 06250 00000 00000 x 1073 
65 536 4 0.15258 78906 25000 00000 x 10^ 
1 048 576 5 0.95367 43164 06250 00000 x 107% 
16 77 216 6 0.59604 64477 53906 25000 x 1077 
268 435 456 7 0.37252 90298 46191 40625 x 108 
4 294 967 29 8 — 0.23283 06436 53869 62891 x 1077 
68 719 476 736 9 0.14551 91522 83668 51807 x 10719 
1 099 511 627 776 10 — 0.90949 47017 72928 23792 х 10 12 
17 592 186 044 416 n 0.56843 41886 08080 14870 x 1019 
281 474 976 710 656 12 0.35527 13678 80050 09294 x 10714 
4 503 599 627 370 496 13 0.22204 46049 25031 30808 x 1013 
72 057 594 037 927 936 14 0.13877 78780 78144 56755 x 10775 
| 152 921 504 606 846 976 15 — 0.86736 17379 88403 54721 x 10718 
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Table J-6. Powers of Ten Converted to Hexadecimal Values 


98 

5Ғ5 

389А 

2 5408 

17 4876 
ЕВ O4A5 
916 4Е72 
SAF3 107А 


n 
0 


о © © N 0 оға о N — 


1.0000 
0.1999 
0.28F5 
0.4189 
0.68DB 
0.A7C5 
0.10C6 
0.1AD7 
0.2 АРЗ 
0.4488 
0.6DF3 
O.AFEB 
0.1197 
0.1C25 
0.2D09 
0.480E 
0.734A 
0.8877 
0.1272 
0.1083 


0000 
999A 
F5C3 
EF9E 
8296 
8423 
8037 
4858 
738F 
52CC 
E ADF 
AAFF 
1119 
81C2 
3604 
566D 
FOAE 
B449 
ABA] 
АС35 
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Table K-4 lists the instructions built into the Z80 microprocessor, which 
is the central processing unit of the TS1000 and the ZX81. The table gives 
the instructions in hexadecimal notation (see Appendix J). 

Some of the instructions in Table K-4 require one or two bytes of data. 
Tables K-1 through K-3 explain notation used for these instructions. Table 
K-1 defines the symbols that represent data bytes in Table K-4. In some cases, 
a single line in Table K-4 represents several instructions. Special symbols 
shown in Table K-2 represent the portion (called a field) that differs from one 
instruction to the next. Table K-3 shows the values that should replace these 
depending on the register involved. 


Table K-1. Symbols for Data Bytes 


Symbol Meaning 


yy One byte of data 
yyyy Two bytes of data 
рраа Two bytes of data giving ап address. The least significant byte is always 
first. 
disp One byte of data, containing the displacement for a relative branch 


Table K-2. Symbols for Instruction Fields 


Symbol Meaning 
bbb Bit number 
ddd Destination register 
rrr Register 
888 Source register 
xx Register pair 
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Table K-3. Contents of Instruction Fields 


Symbol Value Meaning 
ddd, rrr, sss 111 Register A 
000 Register B 
001 Register C 
010 Register D 
011 Register E 
100 Register H 
101 Register L 
xx 00 Register pair BC 
01 Register pair DE 
10 Register pair HL 
11 Register SP or AF 
bbb 000 to 111 Bit number 


O = E ES TS A E PES SI 
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Table K-4. A Summary of the Z80 Instruction Set 
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Table K-4. (Continued) 


ee PALOJSUEN eq oj 
бипнеше $91Aq jO JUNDD E 48 0л E JO $1U91UO02) МО) О; Ающшеш 
Diu шоң бооб 72 jo меню Aq pesseuppe pod ОЛ 0) TH J0 ид 
-uoo Aq pesteJppe uong2o Азошеш WOJ вјер JO 45044 8 Јеј9и01 | 
L- D8) — Пн) 
| - [91 — (a) 
ну — ПОП 
:0 = [8 ] UN јеоден 
.. P949j$U9J) eq о 
Due. 89344 JO junoo R 48 OAOE g JO $} цю) "UBI 01 Аюша 
мој шолу бию8 2 jo 6шәшюэ Aq pesseuppe 109 Q/| 0) 1H 40 #1091 
-U09 Aq реввазрре uongoo, Алошөш шо езер уо ооа 8 293091] 


.. O 10 вшәшоэ ey) Aq pesselppe uod Ол 0) бә) шоу ук) 
[691] — ([2 ] 


Iv] St v-8v 
Hod :/w-ov :sng soppy 
"uod Ол pesseuppe Ацовлр 0) J0je|munoo y Woy зп ПО 
[v ] — [uod 
^, $89Jppg uonguitep pue JUNO) 9344 
qoq 1u9uu9J29(] 7H JO sjuejuoo Aq Pesse:ppe и0119901 AOU 
01 2 JO 83094405 Ад pessaippe 104 Q/| шош аер jo ejAq e өрі 
L- OH] — (н 
1 - (8) — [8 
цо з — OH] 


С ТТ] ~ 
AS EE EE E 


tH 03 


100$8810 Q3 


[9] :siw-8w 


[9] v-0v па sappy.. 


Appendix K: The Machine Language Instruction Set 257 


Table K-4. (Continued) 
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Table K-4. (Continued) 
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Table K-4. (Continued) 
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Table K-4. (Continued) 
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Table K-4. (Continued) 


Aug?) u2ug x чим би uon820| Алошәш JO 83493405 93910 
[dep + (Ax ]] +0 (TH 1] 


Aue?) yBnoiy) цә 4046201 Аошеш ¿O sjU9juOO 99104 
(dsp + (Ах |] 10 ((1H 1) 


AR) YURI Чим 1301 (Bur 
-звалрре eAngje 9594 10 perdu) UOYLIO] Аюшәш JO 51093009 918)0H 
(фер + (Ах ]] 10 [ПН] 


pa AE 


'Buis9eJppe oane eseq 20 Duisssjppe perdu Buisn џешелоед 
L- [Фир + [Ах |] — (дир + [АХ] 40 L - (ПН — (ПН 

BuisseJppe олђејеј eseq ю Bursseuppe рәш! Buren uuau 
L + {бир + [Ах ]] — [дер + [Ax ]] 10 | + [DH] — (ПН) 

popapo әле аб) 94) AUO Buissauppe өл 

-8/94 eseq 20 Burssosppe perdu! Buisn 20jg|nuun92w чим 2994.09 
[дир + (Ах |] - (v ] 20 (DH I] - fv] 

Buissouppe өлцејә: 

eseq 10 Duisssuppe perdu: Buren JOJE¡MUMIIY чим Ho-eArsniox3 
[dsp + [Ax] Ac [М ] — Iv ] © (НА iv] — М] 


30 
дирао 1011151! 


30 82 


91 
dep 99 10111х11 


91 82 


90 
дирао LOLLIXLL 


90 82 


dep S£ LOLLLXLL 
se 

9%1р VE LOLLEXLL 
ve 


Чер 38 LOLLLXLL 
38 


мир 3¥ 22: 1 


(dsip + Ах) 
OH) 


(фир + Ax) 
(лн) 


(dep + Ax) 
(19) 


(dsip + Ax) 


(лн) 
(dsip + Ах) 


(лн) 


(dsip + Ax) 
(лн) 


(dep + Ax) 


emoy pus HIS Аюшәуу 


Азоше уч 


(penunuo2) еоџезејен 
Азерооое5 


262 The ZX81/TS1000 Home Computer Book 


Table K-4. (Continued) 
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Table K-4. (Continued) 
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Table K-4. (Continued) 
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Table K-4. (Continued) 
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Table K-4. (Continued) 
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Table K-4. (Continued) 
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Table K-4. (Continued) 
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Table K-4. (Continued) 
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Table K-4. (Continued) 
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Table K-4. (Continued) 
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The TS1000/ZX81 master program contains subroutines that read the 
keyboard, print on the television display, evaluate functions, manipulate 
strings, perform arithmetic with floating-point numbers, and perform many 
other tasks. The master program calls these subroutines to carry out its usual 
operations, but machine language programmers can also call them from 
machine language subroutines. This capability makes machine language 
extremely powerful and versatile on the TS1000 or 2Х81. 

This appendix explains how to use some of the subroutines in the master 
program. It assumes that you already know how to write machine language 
routines for the Z80 processor, and that you understand some of the technical 
terms that machine language programmers use. 

In many cases, the subroutines described in this appendix change the 
contents of the processor's registers. Some of them also use the alternate 
register set. Before calling them, save the contents of any registers you are 
currently using (with PUSH instructions) and restore them after the call 
(with POP instructions). (These instructions are part of the instruction set of 
the Z80 processor.) 

To find out exactly what each of these subroutines does, or to learn the 
detailed inner workings of other parts of the master program, consult the 
annotated ROM disassembly by Ian Logan and Frank O'Hara (see bibliog- 
raphy in Appendix N). 

Unfortunately, there are two versions of the master program. Some early 
models of the ZX81 have one version whilethe TS1000 and later models of the 
ZX81 have the second version. Both versions contain all of the subroutines 
described in this appendix, but some of the subroutines begin at different 
addresses. To determine which version of the master program your computer 
has, calculate the square of 0.25 and PEEK the contents of location 54. If the 
results are 0.0625 and 136, you have the second version. If either result is 
different, you have the first version. 

Table L-1 gives the calling addresses for some of the more useful subrou- 
tines in the master program. Use the first column of addresses if your 
computer has the older version of the master program. Use the second 
column if it has the newer version. 


lólan Logan, Understanding Your ZX81 ROM (Leighton Buzzard: Melbourne House, 1981), p.1. 
NN ~ 
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HOW TO USE THE SUBROUTINES 


To use one of the subroutines in Table L-1, replace the symbolic name of the 
routine (such as SCAN_KBD) with the corresponding hexadecimal address 


Table L-1. Selected Program Routines 


Symbolic Name 


Old ROM 
Address 


New ROM 
Address 


Effect 


Keyboard Routines 


ea A A AA 


SCAN. KBD 
DECODE. KEY 


02BB 
07BD 


02BB 
07BD 


Determine key value of pressed key 
Convert key value to character code 


Display Routines 


EEE 


PRINT_CHAR 0010 0010 Print a character on the display 
PRINT_ENTER 0847 0847 Move to beginning of next display line 
PRINT_POS 08F5 08F5 Change the print position 
CLEAR_SCR 0A2A 0A2A Clear the display 
РОР. PRINT 0855 0855 (See calculator stack routines below) 
PRINT..STR OB6B OB6B Print a string 
SCROLL_DISP 0COE 0COE Move display up one line 
FAST. MODE 0F20 0F23 Enter FAST mode 
SLOW_MODE 0F28 0F2B Enter sLow mode 
PAUSE.. DISP OF 32 OF 35 Wait a specified time with display on 
Report Code Routines 
REPORT_CODE 0008 0008 Display a report code 
TEST_BREAK OF 43 OF 46 Check for BREAK pressed 
Search Routines 

LOOK. VARS 111B 111C Find a BASIC variable 
FIND. LINE 09DB 09DB Find beginning of a BASIC line 

Calculator Stack Routines 
START_CALC 0028 0028 Begin a series of calculator operations 
POP. PRINT 0855 0855 Print the top item on the stack 
POP. BYTE 0C02 0C02 Round and store top stack number in a byte 
POP_ WORD DEA7 ОЕА7 Round and store top stack number in a word 
PUSH. STR 12BE 12C2 Move a string descriptor onto stack 
FLOAT. STR 14D5 14D9 Convert a string to floating point 
PUSH. BYTE 1519 151D Convert a byte to floating point 
PUSH. WORD 151C 1520 Convert two bytes to floating point 
TEST. STACK 19EA 19EB Check for room to add an item to stack 


ue e A A A AA ie سو‎ 
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from the table. 

In the examples in this appendix, the calling addresses used are taken 
from the list of addresses for the newer version of the master program. If 
your computer has the older version, substitutethe calling addresses used in 
the first column of Table L-1. Each example appears first as it should be 
entered using the REM loader from Appendix F. Following this is a complete 
assembly language listing of the routine, including comments. Unless you 
have an assembler program, you cannot enter the assembly listing directly, 
but it will help you understand how the routine works. To enter one of the 
example routines, insert the LET H$ statement in either of the REM loader 
programs, delete any other LeT H$ statements or filled REM statements from 
previous runs, and make certain the following line is present with nothing 
following it: 


200 РЕН 


Then execute RUN. Since none of the example programs contains the byte 
value 7E, you can edit line 200 to make it line 1 instead of deleting all the 
other lines of the program. Execute each machine language example by 
entering RANDUSR 16514, unless that particular example specifies a different 
command. 


KEYBOARD ROUTINES 


The master program routine SCAN. KBD checks every row on the key- 
board and returns a number in the HL register pair to tell which key, if any, 
was pressed. The numbers it returns (given in Appendix M) are called key 
values. They contain information about the physical location of the key (its 
row and column on the keyboard). Addresses 007E-0110 contain a similar 
table, which the master program routine DECODE K E Y uses to convert the 
key value into a character code (given in Appendix C). 

The first program illustrates the SCAN. КВР апа DECODE_KEY rou- 
tines. It can be called with the following BASIC command: 


PRINT CHR USR 15514 


(Use sLow mode.) The routine waits until you press a key, decodes the key 
value, and returns the corresponding character code to the usr function. To 
print the character code that this program returns, you must release the 
ENTER key quickly after entering the BASIC command, or the routine will 
detect the ENTER key itself. 

Here is the program line to include in the REM loader: 


га LET нф="ср BB @2 44 ар 2C 2 
8 ға CD BD ӘУ? 4E 26 88 СӘ 


ف ف ف NN‏ 
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The complete machine language listing of the program follows: 


Address Contents Instruction Comment 

4082 CD BB 02 L1 CALL SCAN. KBD Read the keyboard 

4085 44 LD B,H Transfer the key value 

4086 4D LD C,L from BC to HL 

4087 2C INCL FF in L means no key pressed 
4088 28 F8 ЈК 7,11 Loop until key pressed 

408A CD BD 07 CALL DECODE. KEY Decode the key value 

408D 4E LD C,(HL) Put character code in C register 
408E 06 00 LD B,00 Clear the B register 

4090 C9 RET Return character code in BC 


This program uses the fact that the key value FFFF (which SCAN. KBD 
returns when no key is pressed) is theonly key value with FF in thelow byte. 
The INC L instruction produces zero in that case, and the following JR Z 
instruction causes the program to loop until some other key value appears. 


DISPLAY ROUTINES 


The master program's routine to display a single character is at hexadec- 
imal location 10. This routine is called PRINT. CHAR. It 


l. verifies that the current print position is valid 

2. determines whether to start a new line 

3. expands the display file if necessary to make room for the 
new character 

4. displays the character | 

5. increases the print position by one. 


You can call this routine directly by loading the character code of the charac- 
ter into register A and executing the instruction RST 10in machine code, or 
you can call it using one of the higher-level routines described in this appen- 
dix. The screen fill program from Chapter 8 is an example of a direct call to 
the PRINT. CHAR routine. 

Here is the line that will load this routine: 


ге LET Нф-”"ЗЕ 95 86 04 GE ва D 
т Әр 20 FC 85 28 F7 ca" 


I?Harold Miller, Syntax ZX30 (The Harvard Group, Bolton Road, Harvard, MA 01451), August 1982, pp 6-7. 
Robert A. Foley, Syntar ZX80, September 1982, p. 17. 
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The complete assembly-language listing of the program follows: 


Address Contents Instruction Comment 

4082 3E 95 LD A,95 Load char. code for Bl into А 
4084 06 04 LD B,04 Load first loop counter into B 
4086 ОЕ BO L1 LD С,В0 Second loop counter into C 
4088 D7 L2 RST 10 Print the character in À 
4089 0D DECC Subtract 1 from counter in C 
408A 20 FC JR NZ,L2 Loop until it reaches 0 

408C 05 DECB Subtract 1 from counter in B 
408D 20 F7 JR NZ,Li Loop until it reaches 0 

408F C9 RET Return to BASIC 


To begin a new line on the display, do not call PRINT. CHAR with the 
character code for ENTER (hexadecimal 76). Call the special routine 
PRINT_ENTER instead. 

Like most of the routines in this appendix, PRINT. CHAR and the rou- 
tines that callit will return to BASIC and display a report code if one of the 
standard errors (such as screen full or out of memory) occurs. Tf your system 
is a ZX81 without the 16K memory expansion, it will report error code 4 (out 
of memory) before the screen fills completely unless you delete the loader 
program after you run it, leaving only the REM statement. 


Print a String 


You can print a string by writing a loop that calls the PRINT.CHAR 
routine. However, the master program already contains such a loop. To use it, 
load the length of the string into BC and the string's starting address into 
DE, and eall PRINT. STR. The example of PRINT. POS in the next section 
includes an example of PRINT. STR. 


Change the Print Position 


To make the equivalent of a PRINT AT command in machine language, load 
the line number into the B register, load the column number into the C 
register, and call PRINT. POS. PRINT_POS does not print anything itself, 
but it moves the print position so that the next call to PRINT_CHAR or 
PRINT. STR begins printing at the new line and column. The following 
subroutine illustrates PRINT. POS followed by PRINT. STR. It prints the 
word HERE at line 10, column 20. To load it with the REM loader, includethe 
following line in the loader program: 


га LET H$="@6 ӨР GE 14 CD FS а 
2 21 04 ва 11 95 40 сер вв aB ca 


ер ЕН 37 ZA 
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The complete assembly-language listing of the program follows: 


Address Contents Instruction Comment 

4082 06 0A LD B,0A Load line number into Á register 
4084 OE 14 LD C,14 Load column number into C register 
4086 CD F5 08 CALL PRINT.POS Change the print position 

4089 01 04 00 LD BC,0004 Load string length into BC 

408C 11 93 40 LD DE,4093 Load string address into DE 

408F CD 6B 0B CALL PRINT_STR Print the string 

4092 C9 RET Return to BASIC 

4093 2D2A372A  DEFS HERE Store the bytes of the string 


Control Routines for the Display 


The following routines perform the same function as the corresponding 
BASIC command given (in parentheses): 


° CLEAR. SCR—Clear the display (CLS) 

: SCROLL. DISP—Meove the display up one line (SCROLL) 

° FAST. . MODE —Select fast mode (FAST) 

: SLOW. MODE —Select slow mode (SLOW) 

* PAUSE. DISP—Activate display and wait a specified time or until a 
key is pressed (PAUSE). Load the parameter (the number that would come 


after PAUSE in the BASIC command) into the BC register before calling 
the routine. 


REPORT CODE ROUTINES 


REPORT. CODE generates a report code at the lower left corner of the 
screen, then returns to BASIC in command mode. Usethe machinelanguage 
instruction RST 8 to call REPORT. CODE, and store one less than the 
desired error number in the next byte. For example, to generate error report 
3, store 2 т the next byte. Appendix B describes the standard BASIC report 
codes, and Appendix E gives the nonstandard ones that you can also use. If 
you attempt to use any other byte values for error codes, you may confuse the 
master program and have to pull the plug. 


TEST BREAK 


TEST BREAK checks the keyboard to determine whether the BREAK key 
has been pressed. The BREAK key does not automatically interrupt a machine 
language routine the way it interrupts a BASIC program. Because of this, if 
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you accidentally write an endless loop, you will be unable to return to BASIC. 
To prevent this, include calls to TEST. BREAK in your routine loops, and use 
REPORT_CODE to exit and generate report D if BREAK has been pressed. 
The following lines show how to do this: 


CD 46 0F CALL TEST. BREAK 


30 02 JR NC,NEXT 
CF RST8 
0C DEFB 0С 


NEXT: continue with program 


SEARCH ROUTINES 


The master program contains a routine to find the memory location of a 
BASIC variable and another to find à BASIC Program line. With these 
routines, you can use BASIC variables to pass parameters between BASIC 
and your machine language routines. This can make it easier to write pro- 
grams that modify the text of BASIC programs (to renumber or merge them, 
for example). 


LOOK._VARS 


The master program routine LOOK. VARS searches the BASIC vari- 
ables area for a variable with a specified name. Before calling it, create a 
sequence of bytes containing the character codes for the variable name, 
followed by a terminator byte, such as FF. Store the starting address of the 
name in the HL register pair and in the system variable CH. ADD. If the 
variable is not found, the carry flag will be clear after the call to LOOK... 
VARS. If the carry flag is set, then HL will contain the address of the last 
character of the variable name. Use the information in Appendix I to find the 
actual bytes of the variable. The examples at the end of the following section 
illustrate the use of LOOK. VARS. 


FIND LINE 


FIND LINE finds the starting address in read/write memory of a BASIC 
line. Load the line number of the line into HL before calling it. The routine 
returns the address of the line in HL if the line exists, or the address of the 
next line if thespecified one does not exist. It also sets thezero flag if the line 
number matched exactly. If the line number is larger than any of the pro- 
gram lines present, FIND. LINE returns in HL the address of a byte con- 
taining hexadecimal 76. 


280 тһе7х81/Т81000 Home Computer Book 


CALCULATOR STACK ROUTINES 


A machine language routine can do arithmetic with floating point 
numbers, concatenate strings, compare numbers or strings, execute numeric 
and string functions, and perform other powerful operations just by calling 
the appropriate master program routine. Thus, machine language routines 
can do essentially anything that BASIC can do. However, a machine lan- 
guage routinethat performs many such operations runs almost as slowly as a 
BASIC program, because it executes the same machine language instruc- 
tions. Floating point arithmetic and function evaluation are especially slow, 
and machine language programmers who need faster programs should use 
integer (non-floating point) arithmetic instead of floating point wherever 
they can. 

The master program uses a caleulator stack, or temporary storage area, to 
evaluate most operations, functions, and other specialized tasks. This stack is 
separate from the machine stack that the stack pointer register (SP) 
accesses. The system variables STKBOT and STKEND (Appendix E) con- 
tain the addresses of the beginning and end of the calculator stack. This stack 
is at the end of the first ^work space" region in read/write memory (Figure 
7-1). Like any other stack, it permits two operations: pushing (adding) a new 
elementontothe stack, and popping (removing) the item most recently added 
tothestack. Each item on the stack is either a five-byte floating point number 
or a five-byte string descriptor, which gives the address and length of a string 
stored somewhere else in read/write memory. 

Each of the calculator's functions gets its arguments by popping them 
from the calculator stack, and it pushes its output value onto the stack. You 
can evaluate a complicated expression very efficiently by arranging the 
calculation so that the input parameters for each operation are already on the 
stack as the output parameters from previous operations. 

The computer uses a special memory area for temporary storage of 
numbers from the stack. The system variable MEMBOT (Appendix E) 
contains the location of this storage area. The master program contains 
routines to transfer items between this area and the stack. 

Using the calculator entails three operations: pushing the arguments onto 
the stack; calling the calculator functions; and accessing the output value on 
the stack. The following sections describe each of these tasks. 


Pushing Arguments onto 
The Stack (Adding an Item) 


The master program has different subroutines for pushing different kinds 
of items onto the stack. Some of these also convert bytes, integers, or charac- 
ter strings into floating point format, so that you should never need to know 
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the internal details of the format. Refer to Table L-1 for the numeric ad- 
dresses of the routines below. 


PUSH-BYTE 


To push an integer between 0 and 255, load the number into the A 
register and call PUSH. BYTE, which converts the byte value to a 
floating point number and stores it on the calculator stack. 


PUSH_WORD 
To push a 16-bit integer, load it into the BC register and call PUSH — 


WORD, which converts the 16-bit value to a floating point number and 
stores it on the calculator stack. 


FLOAT.STR 

To convert a character string to a floating point number and push its 
valueontothestack, (1)storethe address of the first byteof thestring in 
HL and in the system variable CH. ADD (see Appendix E), (2) store 
the contents of the first byte in the A register, and (3) call FLOAT. - 
STR. Thecharacter string must be aseries of adjacent bytes containing 
character codes and ending with a non-numeric code (such as FF). The 
string must represent either an ordinary number or a number in 
scientific notation, just as the PRINT command in BASIC would display 
it on the television screen. For example, the following line creates 
machine language instructions to convert and push the number 1.45. 
Enter it into the REM loader program with: 


The following assembly listing explains more clearly how the subrou- 


tine works: 

Address Contents Instruction Comment 

4082 21 8E 40 LD HL,408E Load address of string into HL 
4085 22 16 40 LD (CH__ADD),HL Store same address in CH_ADD 
4088 46 LD B, (HL) Load first byte of string into A 
4089 78 LD A,B register 

408A CD D9 14 CALL FLOAT_STR Push string’s value on the stack 
408D C9 RET Return to BASIC 

408E 1D1B 2021 DEFS 1.45 Store the string itself 

4092 FF DEFB FF Store the terminator byte 


With this method, you can create and push any floating point number 
within the computer's range. (The single instruction LD A,(HL) would 
be shorter than the two instructions at addresses 4088 and 4089, but its 
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byte value (7E) eauses problems when you edit the REM line.) 

This routine does not produce any visibleresult when you run it unless 
you combine it with other instructions that perform calculations on the 
stack or are used to display items taken from the stack. 


PUSH_STR 

To push a string descriptor, load the address of the first byte of the 
string into DE and the string’s length (in bytes) into BC. Then call 
PUSH_STR. The string can be any sequence of bytes. By pushing a 
string descriptor onto the stack, you make the string available as an 
argument to the string operators and functions. 

To push a number that is already in five byte floating point format, 
store the address of the first byte in HL and execute the following 


instructions: 

Address Contents Instruction Comment 

4082 CD EB 19 CALL TEST. STACK Make sure there is room in 
memory and store 0005 in BC 

4085 ED5B1C40 LD DE, (STKEND) Get address of top of stack 

4088 ED Во LDIR Transfer 5 bytes 

408A ED 53 1C 40  LD(STKEND), DE Store new top of stack 


Accessing items on the Stack 


The master program has different subroutines for popping (removing) 
different kinds of items from the stack. Some of these also convert floating 
point format into bytes or integers, and some print the popped item on the 
television display. With these routines, you will never need to learn the 
internal details of floating point format. Refer to Table L-1 for the numeric 
addresses of the routines below. 


POP.BYTE 
Call POP. BYTE to pop a number whose value is between 0 and 255, 
round it to an 8-bit integer, and store it in the A register. Report code B 
results if the result is not between 0 and 255. Register C contains the 
value 1 if the floating point number was positive, or FF if it was 
negative. 


POP-WORD 


Call POP. WORD to pop a number whose value is between 0 and 65535, 
round it to a 16-bit integer, and store it in the BC register pair. Error 
report B results if the floating point number was not in the range 
0-65535. 
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POP-PRINT 


Call POP. PRINT to pop a number or a string from the calculator stack 
and print the number or string at the current print position on the 
television display. This routine examines the system variable FLAGS at 
address 4001 to determine whether the stack item is a floating point 
number or a string descriptor. 

To pop à number and store it elsewhere in five-byte floating point 
format, load the destination address of the first byte into HL and 
execute the following instructions: 


Address Contents — Instruction Comment 

4082 01 05 00 LD BC,0005 Prepare to move five bytes 

4085 09 ADD HL,BC HL now contains address of last 
byte 

4086 EB EX DE,HL DE now contains address of last 
byte 

4087 2A 1C 40 LD HL(STKEND) Put next address after stack in HL 

408A 2B DEC HL HL now holds last address on stack 

408B ED B8 LDDR Transfer five bytes 

408D 23 INCHL Get next address after new stack 

408E 22 1C 40 LD (STKEND)HL Store it 


Calling Calculator Routines 


The instruction RST 28 calls calculator routines. Immediately after, the 
RST 28 instruction stores one or more bytes to tell the calculator which 
operations you want. These bytes are called calculator codes. The calculator 
will perform the operations in order, leaving the output of each operation on 
the stack and expecting to find the input or inputs for the next operation on 
the stack. Table L-2 lists the calculator routines and gives the calculator code 
to put after RST 28 for each one. 

After the byte for the last operation, enter a byte containing hexadecimal 
34 to mark the end of the calculator calls, and continue with the rest of your 
subroutine. 

You can pass the operation code from Table L-2tothe calculator by placing 
it between the RST 28 instruction and the byte value 34, or you can load the 
operation code into the B register and use 37 after the RST 28 instruction. 
The byte value 37 tells the calculator to use the value in the B register as the 
operation code. The comparison operations (greater than, less than, and so 
on) will not work correctly unless you load them in this fashion. The other 
operations will work with either kind of call. To use byte 37, you will need to 
exit caleulator mode (by entering hex 34). Then set the B register and enter 
RST 28, hex 36, and hex 34. 
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Table L-2. Calculator Codes 


Value Left 
Code Operation on Stack Comments 
Constants 
А0 0 
А1 1 
А2 0.5 
A3 3.1415927 / 2 
A4 10 
Arithmetic Operations 

03 Subtract UNDER — TOP 

Multiply UNDER * TOP 
05 Divide UNDER / TOP 

Take number to a power UNDER ** TOP 
OF Add two numbers UNDER + TOP 
18 Negate (unary minus) — TOP 
2E  Modulus UNDER MOD TOP Remainder is second on stack 

Numeric Functions 
1С Sine SIN TOP 
1D Cosine COS TOP 
1E Tangent TAN TOP 
1F Arcsine ASN TOP 
20  Arccosine ACS TOP 
21  Arctangent ATN TOP 
22 Natural logarithm LN TOP 
23  Exponential (base e) EXP TOP 
24 Integer part INT TOP Rounds down 
25 Square root SQR TOP 
26 Signum SGN TOP 
27 Absolute value ABS TOP 
28 Contents of address PEEK TOP 
29 Subroutine parameter USR TOP Calls a subroutine 
36 Truncate Truncation of TOP Rounds toward zero 
Relational Operations on Numbers 
(Value is 1 if true, 0 if false) 

37 Less than or equal UNDER <= ТОР Call with 09 in B register 
87 Greater than or equal UNDER >= TOP Call with ОА in B register 
37 Not equal UNDER < > TOP Call with 0B in B register 
37 Greater than UNDER > TOP Call with 0C in B register 
37  Lessthan UNDER « TOP Call with 0D in B register 
37 Equal UNDER - TOP Call with OE in B register 
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Table L-2. (Continued) 


32 Less than zero ТОР<0 
33 Greater than ТОР>0 ТОР>0 
Logical Operations on Numbers 
(Value follows rules for BASIC, 
Chapter Six) 
07 Or UNDER OR TOP 
08 And UNDER AND TOP 
2C Not NOT TOP 
Operations on Strings 
17 Concatenate UNDER + TOP Both UNDER and TOP are strings 
10 And UNDER AND TOP UNDER is a string, TOP is a number 
11 Less than or equal UNDER <= TOP Both UNDER and TOP are strings 
12 Greater than or equal UNDER >= TOP Both UNDER and TOP are strings 
13 Not equal UNDER < > TOP Both UNDER and TOP are strings 
14 Greater than UNDER » TOP Both UNDER and TOP are strings 
15 Less than UNDER < TOP Both UNDER and TOP are strings 
16 Equal UNDER = TOP Both UNDER and TOP are strings 
String Functions 
19 Character code CODE TOP String argument, numeric value 
1А Value of string VAL TOP String argument, numeric value 
1B Length of string LEN TOP String argument, numeric value 
2A String representation STR$ TOP Numerie argument, string value 
2B Character string CHR$ TOP Numeric argument, string value 
Stack Manipulation 
01 Exchange (switch) top and second items on stack 
02 Delete top item on stack 
2D Duplicate top item on stack 
CO Copy top item from stack to memory cell zero Stack does not change 
C1 Copy top item from stack to memory cell one Stack does not change 
C2 Copy top item from stack to memory cell two Stack does not change 
СЗ Copy top item from stack to memory cell three Stack does not change 
C4 Copy top item from stack to memory cell four Stack does not change 
C5 Copy top item from stack to memory cell five Stack does not change 
EO Push contents of memory cell zero onto stack 
El Push contents of memory cell one onto stack 
E2 Push contents of memory cell two onto stack 
E3 Push contents of memory cell three onto stack 
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Relational Operations on Numbers 
(Value is 1 if true, 0 if false) 


Table L-2. (Continued) 


IVA м па д. 


Stack Manipulation 


д 


E4 Push contents of memory cell four onto stack 
E5 Push contents of memory cell five onto stack 


Control Operations 
——Á ÉL ————, ey a %- 


2F Branch forward or backward in the list of character codes currently being executed. 
The byte following the 2F code contains the positive or negative offset for the branch 


00 Jump (as described above) if the top item on the stack is true (not zero) 


Note: Thesymbols TOP and UNDER denote the top item on the stack and the second item from the 
top, respectively. 


Using the Auxiliary Memory 


Since each calculator routine gets its parameters from the calculator stack 
and returns its value to this stack, you must arrange the operations on the 
stack so that the right parameters are there in the right order for the next 
operation. 

The stack operations DUPLICATE, EXCHANGE, and DELETE can re- 
arrange items on the stack. 

The computer has six (five-byte) auxiliary Storage cells that can store 
floating point numbers from the stack. You can use these cells as you would 
use the memories of a pocket calculator. 

Each of the code bytes C0-C5 pops a number from the calculator stack and 
stores it in the corresponding cell (0-5). Conversely, the code bytes E0-E5 
each retrieves a number from one of the cells and pushes it onto the stack. 


Calculator Examples 


The following subroutines illustrate the calculator routines. Use either 
REM loader program from Appendix F to enter them, and run them using the 
command RAND UsR 16514 unless the example specifies differently. 


l. The first subroutine converts a decimal number to floating point, takes 
its square root, and prints the result. The REM loader program line is: 


SS eB 
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The complete assembly listing is 


Address Contents Instruction Comment 

4082 21 94 40 LD HL,4094 Load address of string into HL 
4085 22 16 40 LD (CH. ADD)HL Store same address in CH. ADD 
4088 46 LD B, (HL) Load first byte of string into À 
4089 78 LD A,B register 

408A CD D9 14 CALL FLOAT. STR Push string's value on the stack 
408D EF RST 28 Call the calculator routine 
408E 25 DEFB 25 Take the square root 

408F 34 DEFB 34 End of call to calculator 

4090 CD 55 0B CALL POP. PRINT Display the result 

4093 C9 RET Return to BASIC 

4094 23 1B 22 2A 21 DEFS 7.6E5 Store the string 

4099 FF DEFBFF Store the end-of-string marker 


This example illustrates a single calculator call, with one command byte 
(25) and the stop byte (34) after the RST 28 instruction. It also shows how 
to convert a string into a floating point number with FLOAT. STR and 
how to print the last item on the stack with POP. PRINT. 

You ean change the numeric string and try the routine again using the 
EDIT key. As long as you leave the terminator byte FF at the end of the 
string (it appears as the COPY keyword on the display), you are free to 
lengthen or shorten the string. Try several different strings, both in 
ordinary decimal notation and in scientific notation. To see what 
happens, try some illegal strings too, such as 2E99 (out of range) and 
A%3K (not a number). 


The second routine pushes two string descriptors onto the stack, concat- 
enates them with the + operator, and prints the result. The program line 
for the REM loader is 

га LET H$-"11 ЗЕ 40 01 205 ва C 
С NB 12 11 Az 48 21 85 ай CD 
: EF 1? за CD 55 8B са 28 34 33 
ев 39 FF рп 33 26 за 2H FF " 


The complete assembly listing follows: 


Address Contents Instruction Comment 

4082 11 9B 40 LD DE,409B Address of first string 

4085 01 06 00 LD BC,0006 Length of first string 

4088 CD C2 12 CALL PUSH_STR Push first string descriptor 
408B 11 A2 40 LD DE,40A2 Address of second string 
408E 01 05 00 LD BC,0005 Length of second string 

4091 CD C2 12 CALL PUSH. STR Push second string descriptor 
4094 EF RST 28 Call the calculator 

4095 17 DEFB 17 Concatenate the strings 


S 
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4096 34 DEFB 34 End of calculator call 


4097 CD 55 0B CALL POP. PRINT Print the concatenated string 
409A C9 RET Return to BASIC 

409B 28 34 33 28 26 39 DEFS CONCAT Store the first string 

40A1 FF DEFB FF Store the string terminator 
40A2 2A 33 26 392A DEFS ENATE Store the second string 

40A7 FF DEFB FF Store the string terminator 


Unlike the earlier example of decimal string conversion, this routine 
requires you to specify the length of the string in the BC register so you 
can push its descriptor onto the stack. You can edit the REM statement 
containing this routine to change bytes in the strings, but you cannot use 
EDIT to change the length of the strings. Instead, you must edit the 
hexadecimal listing in line 20 and run the loader program again. 


3. The third subroutine converts two integers to floating point, takes the 
first to the power specified by the second, and prints the result. The REM 
loader lin» is 

га LET Há="EC 48 7B da CD 1 
5 SA 21 40 CD HMM 15 ЕР а 34 CD 
AF GE СӘ” 


The complete assembly listing is 


Address Contents Instruction Comment 

4082 ED 4B 7B 40 LD BC,(407B) Load base number into BC 

4086 CD 20 15 CALL PUSH_WORD Convert and push on stack 

4089 3A 21 40 LD A,(4021) Load exponent into A 

408C CD 1D 15 CALLPUSH. BYTE Convert and push onto stack 
408F EF RST 28 Call the ealeulator 

4090 06 DEFB 06 Calculator exponential 

4091 34 DEFB 34 End of calculator call 

4092 CD АТ 0E CALL POP. WORD Pop and convert to integer in BC 
4095 C9 RET Return to BASIC 


After you have stored this program in a REM statement with the REM 
loader program, POKE the exponent into location 16417. The exponent 
must be between 0 and 255. Then POKE the low byte of the other number 
into 16507 and the high byte into 16508 (as described in Chapter 7). 

Since this routine uses POP. WORD instead of POP. PRINT, you must 
execute it with PRINT USR 16514 in order to see the value that it returns 
in the BC register pair. Try POKEing different values for the two 
numbers. Does the routine interpret a negative exponent correctly? 
What happens if the resulting value is out of range? 


eee 
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4. The next subroutine converts two integers to floating point, takes the 
cosine of each, compares the two cosines, and prints them in numerical 
order (the smaller one first) Load it with: 


га LET Н$="ЗА 75 40 CD 15 E 

Е 1: гр 34 3 ? жә CD 15 EF 
ір са 01 ЕФ 34 а OC EF 37 00 Oe 

рі да CC 55 ӘБ ЗЕ FE CF Ср 55 8 
Boa " 
Address Contents Instruction Comment 
4082 3A 7B 40 LD A,(407B) Load first number into A 
4085 CD 1D 15 CALLPUSH_BYTE Convert and push it 
4088 EF RST 28 Call the calculator 
4089 1D DEFB 1D Take cosine of first number 
408A 2D DEFB 2D Duplicate cosine on stack 
408B 34 DEFB 34 End of calculator call 
408C 3A 7C 40 LD A,(407C) Load second number into A 
408F CD 1D 15 CALL РОЗН BYTE Convert and push it 
4092 EF RST 28 Call the calculator 
4093 1D DEFB 1D Take cosine of second number 
4094 CO DEFB CO Store it in memory 0 
4095 01 DEFB 01 Exchange top 2 numbers on stack 
4096 EO DEFB EO Push number from memory 0 
4097 34 DEFB 34 End of calculator call 
4098 06 0C LD B,0C Load compare > byte into B 
409A EF RST 28 Call the calculator 
409B 37 DEFB 37 Compare top 2 numbers on stack 
409C 00 DEFB 00 Jump if greater 
409D 02 DEFB 02 Jump length is 2 bytes 
409E 01 DEFB 01 Exchange top 2 numbers on stack 
409F 34 DEFB 34 End of calculator call 
40A0 CD 55 0B CALL POP. PRINT Pop and print top number 
40A3 3E 76 LD A,76 Load ENTER code into A 
40A5 D7 RST 10 Print it to go to next line 
40A6 CD 55 0B CALL POP. PRINT Pop and print from stack 
40A9 C9 RET Return to BASIC 


This routine gets two integers, which must be between 0 and 255, from 
the byte values you POKE into locations 16507 and 16508 before you 
execute RAND USR 16514. Begin by POKE ing the numbers 2 into 16507 
and 3 into 16508. Then run the routine and observe the result. Next, 
POKE 3 into 16507 and 2 into 16508, and run the routine again. Each 
time the computer prints the numbers like this: 


—0.9899925 
—0.41614684 


_______ ——————— A — M — tK — 
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It compares the cosines of the two inputs, printing the smaller one first, 
regardless of their original order. 

This example illustrates several kinds of stack manipulations. First, it 
stores the cosine of the first number on the stack twice, using calculator 
code 2D to duplicate it. Then it pushes the cosine of the second number 
onto the stack so it will look like this: 


COS SECOND 


COS FIRST 
COS FIRST 


Calculator Stack 


STKEND 


STKBOT 


After that, the computer stores the top cosine in memory location zero (a 
copy of it remains on the stack) and exchanges the top two items on the 
stack (calculator code 01), like this: 


COS SECOND 
COS FIRST 
COS FIRST 


alculator Stack Memory 0 


STKEND 


STKBOT 


Next the computer pushes the cosine of the second number from 
memory location zero onto the stack, which now contains alternating 
copies of the two cosines: 


COS FIRST 
COS SECOND 
COS FIRST 


Calculator Stack Memory 0 


STKEND 


COS SECOND 


STKBOT 
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With the cosines stored in this way, the routine uses calculator code 0C 
to pop and compare the top two values on the stack. Notice that the 
routine calls the comparison operator with byte value 37 and with the 
comparison code 0C in the B register. Comparisons do not work with the 
other calling method. The test removes the top two items, leaving 1 (true) 
onthestack if thesecond valueon thestack is greater than the top value. 
Otherwise, it leaves 0. 


Caleulator Stack 


The jump-true operator (caleulator code 00) will remove the test result, 
causing the calculator to skip the exchange instruction (calculator code 


e AA E EE : ded 
If the test result is false, the jump-true operator will cause the calcula- 
tor to skip only one byte (the jump length), executing the exchange 
instruction, which will switch the order of the top two items on the stack. 
That way, when the two POP. PRINT instructions print their numbers, 


they will be in correct numerical order. 


CALCULATIONS WITH BASIC VARIABLES 


The master program routine LOOK. VARS searches the BASIC vari- 
ables area for a variable that you specify. By using this routine and the 
calculator stack, you can pass floating point parameters between BASIC and 
machine language subroutines in the form of BASIC variables. 

The following examples illustrate this capability. 


Push a BASIC Variable onto the Stack 


The following subroutine finds a siniple numeric variable in the BASIC 
variables area, pushes its value onto the calculator stack, and prints it from 
thestack to verify that it was accessed correctly. The BASIC program lineto 
load this routine with the REM loader is 
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га LET H$z2'"21 на 40 22 15 
> C 11 СЯ 46 ег 22 

SB 1: 48 ED Ва ED 53 1C dea 
VB c2 22 FF " 


ra 
EL 
С 


The complete assembly listing is 


Address Contents Instruction 

4082 21 A0 40 LD HL,40A0 

4085 22 16 40 LD (CH_ADD),HL 
4088 CD 1C 11 CALL LOOK. VARS 
408B DA 4B 0D JP C,ERR. 2 

408E 23 INC HL 

408F CD EB 19 CALL TEST. STACK 
4092 ED5B1C40 LD DE(STKEND) 
4096 ED Bo LDIR 

4098 ED 53 1C 40 LD(STKEND),DE 
409C CD 55 0B CALL POP. PRINT 
409F C9 RET 

40A0 33 DEFSN 

40A1 FF DEFB FF 


co mE 18 ED 


Comment 


Load string address into HL 
Also store it in CH. ADD 
Find variable with that name 
Report error if undefined 

Get address of first byte 
Enough memory to push on stack? 
Get address of top of stack 
Transfer five bytes 

Store new top of stack 

Print value of variable 
Return to BASIC 

Create variable name 
Terminate name string 


To test this routine, first define a BASIC variable N with a LET statement. 
Then execute RAND USR 16514, followed by PRINT N. The computer should 
print the value you assigned to N in the LET statement. To use a different 
variable name (of any length), edit the REM statement to incorporate the new 
variable name. 


Transfer a Number from 
the Stack to a BASIC Variable 


The following subroutine pushes the value 2 onto the calculator stack, 
takes its square root, finds a numeric variable N inthe BASIC variables area, 
and stores the square root in that variable. The BASIC program line to load 
this routine with the REM loader is 


EEE 
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The complete assembly listing is 


Address 


4082 
4084 


4087 
4088 
4089 
408A 
408D 
4090 
4093 


4096 
4099 
409A 
409B 
409E 
409F 
40A1 


40A2 
40A5 
40A6 
40A7 


Contents 


3E 02 
CD 1D 15 


EF 

25 

34 

21 A6 40 
22 16 40 
ерісі 
DA 4B 0D 


01 05 00 
09 

EB 

2A 1C 40 
2B 

ED B8 
23 


22 1C 40 
C9 
33 
FF 


Instruction 


LD A,02 
CALL PUSH. BYTE 


RST 28 

DEFB 25 

DEFB 34 

LD HL,40A6 

LD (CH_ADD),HL 
CALL LOOK_VARS 
JP C,ERR_2 


LD BC,0005 

ADD HL,BC 

EX DE,HL 

LD HL(STKEND) 
DEC HL 

LDDR 

INC HL 


LD (STKEND),HL 
RET 

DEFS N 

DEFB FF 


Comment 


Store 2 in register A 

Store 2 on stack in floating 
point 

Start the calculator routine 

Take square root of stack value 

Exit the calculator routine 

Store string address in HL 

And in CH. ADD 

Find the specified variable 

Report error if variable un- 
defined 

Prepare to move five bytes 

HL holds address of last byte 

DE holds address of last byte 

Put address after stack in HL 

HL now holds last stack address 

Transfer five bytes 

Get next address after new 

stack 

Store it 

Return to BASIC 

Create variable name 

Terminate name string 


Before running this routine, you must define a variable N using a LET 
statement. The value you give it does not matter. Run the routine with RAND 
USR 16514 and PRINT N. The computer will print 1.4142136, which is the 
square root of 2. 
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If you access the master program routine, SCAN. КВР, it will return а 
value that indicates which keys, if any, have just been pressed. Figure M-1 
shows the hexadecimal values that will be returned each time a single key is 
pressed. 

If the знтет key and one of the keys are pressed together, one of the 
hexadecimal values shown in Figure M-2 will be returned. 

When no keys are pressed, SCAN. KBD will return the hexadecimal value 
FFFF. 


FDF7 FBF7 F7F7 EFF7 DFF7 DFEF] | EFEF| | F7EF FBEF| |FDEF 
1 2 3 4 5 6 7 8 9 0 
FDFB FBFB F7FB EFFB DFFB DFDF| | EFDF F7DF FBDF| | FDDF 
Q м Е R T Y U I 0 P 


FDFD| | ЕВЕР” | | F7FD EFFD| |DFFD| | DFBF| | EFBF F7BF FBBF 
A 8 D F G H J K L | ER 
FBFE| | F7FE EFFE| | DFFE DF7F EF7F ЕТТЕ FB7F FD7F 
Z X C V B N M . ЗРАСЕ 


Adapted from Understanding Your ZX81 ROM Бу 
lan Logan (Cheddington, Leighton Buzzard, Bedford- 


shire, UK: Melbourne House Ltd., 1982). 


Figure M-1. Hexadecimal key values for unshifted keys 
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EDIT AND | |THEN TO «a <> <> c GRAPHICS} | DELETE 
FCF7 КАЕТ F6F7 EEF7 DEF7 DEEF EEEF| | F6EF FAEF| | FCEF 
z ов | [ЗТЕР| | <= <> >= $ ( ) . 
FCFB| |FAFB| | Е6ЕВ| |EEFB| | DEFB| |DEDF| |EEDF| | F6DF | [FADF | | ЕСПЕ 


STOP | [PRIN SLOW FAST LLIST - + = FUNCTION 
FCFD RAPD | F6FD EEFD| |DEFD EEBF F6BF FABF FCBF 
: ; ? / . < > , £ 
FAFE F6FE EEFE| |DEFE DETF ЕЕТЕ F67F FATF ЕСТЕ 


Figure M-2. Hexadecimal key values for shifted keys 


Ian Logan (Cheddington, Leighton Buzzard, Bedford- 


Adapted from Understanding Your ZX81 ROM by 
shire, UK: Melbourne House Ltd., 1982). 
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Park, N.J.: Hayden Book Co., 1980. 


Coan, James S. Advanced BASIC. Rochelle Park, N.J.: Hayden Book Co., 
1976. 


. Basic BASIC. 2nd ed. Rochelle Park, N.J.: Hayden Book Co., 1978. 
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Hurley, Randle. The Sinclair ZX81. Programming for Real Applications. 
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Osborne/MeGraw-Hill, 1979. 
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shire, U.K.: Melbourne House, 1981. 


. Sinclair ZX81 ROM Disassembly. Part A: 0000H-0F 54H. Leighton 
Buzzard, Bedfordshire, U.K.: Melbourne House, 1981. 


Logan, Ian, and Frank O'Hara. Sinclair ZX81 ROM Disassembly Part B: 
0F55H-1DFFH. Leighton Buzzard, Bedfordshire, U.K.: Melbourne House, 
1982. 
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1 and 2. Indianapolis: Howard W. Sams, 1979. 
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cepts. 2nd ed. Berkeley: Osborne/McGraw-Hill, 1980. 
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ee 
Appendix N: References and Further Reading 304 
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ABS function, 74-76, 189 
ACS function, 80, 189-90 
Arithmetic operations 
overflow of, 198-99 
priority of, 34-35, 61 
use of parentheses in, 35 
Arrays, 123-31, 142 
dimensioning, 124-25 
elements of, 123 
index of an element of, 123 
multi-dimensional, 128-29 
names, 123 
sorting elements of, 126-28 
string, 129-31 
Arrow keys. See cursor control keys. 
ASN function, 80, 190 
ATN function, 80, 190 


BREAK command, 53, 89, 178-79, 
200 
Bytes, 4, 7 
addresses of, 154 
less significant, 158 
more significant, 158 


С 


Cassette player, 21-26, 52-53 
adjusting to load a program, 22-24 
adjusting to save a program, 52-53 
selection of, 22 
using program counter on, 53 

Cassettes 
care of, 25 
data storage on, 141- 42 
labeling programs on, 25 


Cassettes, continued 
loading a program from, 23-24 
saving a program onto, 51-53 
write-protect notches, 25-26 
Central processing unit (CPU). See 
microprocessor. 
Character codes, 84, 119, 147, 204, 
277 
CHRg function, 85, 120, 190 
CLEAR command, 45, 179 
CLS command, 100, 179 
CODE function, 85, 190-91 
Command mode, 41, 176 
Commands, 30-31, 176-78 
defined, 30 
entering, 31 
Constants, 62-63 
function, 78 
string, 67 
CONT command, 100, 180 
COPY command, 103, 180 
COS function, 80, 191, 291 
Cursor 
appearance of, 12 
characters, 14 
control keys, 16, 49-50 
function of, 6 


D 


DELETE key, 48 
DIM statement, 124-25, 180-81, 197 
Display files, 162-63 


Edit cursor, 49 
EDIT key, 49, 96 
ENTER key, 17-18, 31 
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Error codes. See report codes. 
EXP function, 76, 191 
Expansion interface, 6 
Expressions, mixed 

priority of, 153 


F 


FAST command (mode), 46, 97, 170, 
173, 181 

FOR statement, 116-23, 125, 181. 
See also Loops. 

FUNCTION key, 16 

Functions, 74-85, 189 
arguments of, 74 
constant, 78 
numeric, 74-77 
string, 81-85 
trigonometric, 80 
use of parentheses with, 75 
values of, 74 


G 


GOSUB statement, 134-35, 139, 162, 
182, 199 
GOTO statement, 106-10, 139, 162, 
182 
producing loops with, 107-08 
with IF-THEN statement, 109 
Graphics characters, 102-03 
GRAPHICS key, 17, 96, 170-71 
Graphs, 142-45 


IF-THEN statement, 55-57, 109-16, 
182 
making decisions with, 109-10 
relational tests, 111-13 
use with logical operators, 114-16 

Immediate mode. See command 
mode. 

INKEY$ function, 81-82, 191 

INPUT statement, 88-89, 113, 183, 
199 

INT function, 77-78, 192 


K 
Kbytes, 7. See also Bytes. 
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Keyboard, 6, 14-18 
codes of symbols, 204-09 
cursor control keys, 16 
entering machine language 
routines with, 170 
functions on, 16 
graphics characters on, 98 
routines, 276-77 
symbols, 20 
values of keys, 296-97 
Keywords, 15 


L 


LEN function, 82-83, 192 

LET statement, 36-41, 169, 183. 
and string concatenation, 69 
and string slicing, 71 
See also Variables. 

LIST command, 44, 183-84 
moving the edit cursor with, 50 

LLIST command, 184 

LN function, 80, 192 

LOAD command, 23, 184 

Logical expressions, 144-16, 146-53 
branching with, 151-52 
opposite and equivalent, 146-47 
true/false tests, 148-50 
truth tables, 149 

Logical operations 
priority of, 115 
on strings, 152 

Loops 
control variable in, 116-17 
INPUT, 170-71 
nested, 120-21 
rules for, 123 
use of STEP in, 117-18, 121-23 

LPRINT AT statement, 95 

LPRINT statement, 33, 184-85 
commas in, 90-91 
producing graphies with, 102-03 
semicolons in, 92 

LPRINT TAB statement, 94 


M 


Machine language 
instructions, 254, 274 


Machine language, continued 
loader programs for, 171, 173, 
220-23, 228, 276 
above RAMTOP, 171-73 
in a REM statement, 167-71 
subroutines, 167-71, 274-94 
Master program, 7, 166, 216, 274-76 
Memory capacity, 7, 47, 197-98 
Memory pack, 16K 
connection of, 12 
display files with, 163 
memory capacity without, 47 
RAMTOP with, 158 
use of, 27 
Microprocessor, 4, 6-7 


N 


NEW command, 20, 45, 185 
NEXT statement, 116-23, 125, 185. 
See also Loops. 
Null string. See String, empty. 
Numbers 
floating point format, 65, 154, 
234-35, 281-82 
hexadecimal, 242-48, 244-49 
random, 78-80 
ranges allowed, 65 
rounding off, 65, 77-78 
Numeric expressions, 62 


O 


Operators 
arithmetic, 33-35 
logical (Boolean), 114-16 
relational, 111-13 
unary vs. binary minus sign, 61 


P 


PAUSE command, 96-97, 101, 185 

PEEK function, 85, 154-56, 159, 163, 
192 

PI function, 76, 193 

Picture elements. See Pixels. 

Pixels, 98-100, 142, 186 

PLOT command, 98-100, 102, 185-86 

POKE statement, 154-57, 163, 172, 
186 


PRINT AT statement, 94-96, 98-100, 
163 
PRINT statement, 31-33, 186 
commas in, 90-91 
producing graphics with, 98, 
102-03 
rounding off, 65 
and scientific notation, 64 
semicolons in, 92-93 
PRINT TAB statement, 93-94 
Printer, 26-27, 33 
printing tables, 90-91 
Program lines 
deletion of, 47 
entering, 42-43 
inserting and changing, 48 
number of commands in, 45 
numbering of, 45, 62 
position of cursor when entering, 
49 
renumbering of, 161-62, 226-28 
search routine for, 280 
spacing of, 20 
storage of in RAM, 159-62 
Programmed mode, 42, 176 
Programs, computer 
defined, 42 
improving clarity of, 138-39 
menus for, 151 
merging, 228-31 
shortening, 140-41 
speeding up, 139-40 
variables area, 162-63 


Q 
Quote image key, 66 


R 


Radians 
converting to degrees, 80 

RAMTOP (system variable), 157-59, 
171-73, 222-23, 226 

RAND command, 78, 169, 172, 187 

Random-access memory. See 
Read/write memory. 

Random number generator. See RND 
function. 
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Read-only memory (ROM), 7, 84, 
154, 166 
Read/write memory (RAM), 7, 154, 
157-59, 216, 238 
REM statement, 45-46, 139, 186-87 
machine language in, 167-71, 
220-24 
Report codes, 50-51 
invalid function argument, 
199-200 
memory full, 197-98 
others, 201 
routines for, 279-80 
undefined variables, 196-97 
RETURN statement, 134, 187 
RND function, 78-80, 193 
RUN command, 43, 187 


$ 


SAVE command, 51-53, 187- 88, 200 
Scientific notation, 63-64, 234 
exponent of, 63 
mantissa of, 68 
SCL. See Sinclair Computer Logic 
chip. 
Screen display 
clearing, 100 
when executing a machine 
language subroutine, 169 
formatting, 90-94 
when full, 198 
when loading a program, 24 
when memory is full, 47 
print position on, 93, 278-79 
problems with, 212-13 
routines for, 277-79 
when saving a program, 52 
size of, 6 
when using PAUSE command, 97 
SCROLL command, 100-01, 140, 188 
SGN function, 76, 193 
SIN function, 80, 145, 193 


Sinclair Computer Logic chip (SCL), 


5 
Slicing command, 70-72, 129-30 
SLOW command (mode), 46, 97-98, 
101, 173, 188 
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SQR function, 80, 194 
Stack (memory storage area), 281-94 
adding an item to, 281- 83 
BASIC variables and, 292-94 
calculator codes in, 284-87 
defined, 281 
removing an item from, 283-84 
STOP command, 89, 110, 135, 188, 199 
STR3 function, 83, 194 
String expressions, 68- 74 
concatenating, 68-69 
inserting, 72-73 
operations, priority of, 73 
slicing, 69-72 
Strings 
arrays, 129-31 
constants, 67 
defined, 66 
empty, 66 
equality of, 112-13 
variables, 67-68 
Subroutines, 132-36, 139-40, 167-71 
defined, 134 
machine language, 158, 167-71 
nested, 136 
variables in, 135-36 
Substitution command, 72-73 
Substrings, 69-72 


T 


TAN function, 80, 194 
Television switch box, 10 


U 


UNPLOT command, 98-100, 102, 
188-89 
USR function, 166-67, 169, 172, 194 


۷ 


VAL function, 83-84, 200 
Variables 
in arrays, 123-25 
control, 116-23, 196 
defined, 36 
initializing, 117 
input, 88-89 
naming of, 37, 139 
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Variables, continued 
numeric, 89, 238 
rules for using, 38-39 
search routine for, 280 
string, 67-68 
system, 154, 157, 216-18, 238 
undefined, 196-97 


Variables, continued 
values of, 37 
vs. constants, 62-63 
Video cable, 10 
Video modulator, 5 
Voltage regulator, 5 
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` With the simple, illustrated instructions іп The ZX81™/TS1000™ 
Home Computer Book even a first-time computer user can oper- 
ate the ZX81 and TS1000 computers like a pro. Create imagina- 
tive graphics and animation designs, build BASIC programming 


` Skills, even write your own software! 


` / The ZX81™/TS1000™ Home Computer Bock gives you 


fi . e Complete, easy-to-follow operating instructions for the 


computers (both ROM versions) and their peripherals 
| including cassette recorder and printer. 
‚ Step-by-step tutorials in BASIC programming that take 
. youfrom beginning procedures to advanced techniques. 
“е Easy instructions in graphics and animation design that 
уои can apply to your own games, charts, and drawings. - 


A thorough introduction to computer functions complete , 


with a chapter on machine language techniques. 


In addition, The 27х81 "/TS1000'" Home Computer Book will be 


your invaluable reference tool for as long 8s you use your ZX81 
ог TS1000, providing you with a summary of BASIC commands 
and functions, PEEK and POKE locations, a memory map, and 
` other excellent resources. i 


ZX81 is a trademark of Sinclair Research Limited. 
-TS1000 is a trademark of Timex Computer Corporation. 


